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Introducción 


La iniciativa NET Framework de Microsoft supone el cambio mas importan¬ 
te en la metodología del desarrollo de software para un sistema operativo de 
Microsoft desde la introducción de Windows. Este entorno está construido usan¬ 
do una arquitectura que permite a los lenguajes de software trabajar juntos, com¬ 
partiendo recursos v código, para proporcionar a los programadores las avanzadas 
herramientas necesarias para construir la siguiente generación de aplicaciones 
de escritorio y de Internet. Visual Studio NET de Microsoft incluye nuevas ver¬ 
siones de sus productos de compilador Visual Basic y C++ dirigidas al desarrollo 
de NET. al igual que un lenguaje completamente nuevo llamado C#. 

Este libro le mostrará cómo escribir código usando este novísimo lenguaje. 
Todos los términos de lenguaje tales como declaraciones, variables, bucles de 
control v clases, son tratados con detalle. Además, el libro le enseñará a usar C# 
para programar tareas con las que los programadores suelen enfrentarse en el 
mundo real. La ultima parte del libro explica como usar C# para desarrollar 
paginas Web, acceder a bases de datos, trabajar con objetos COM y COM + 
heredados, desarrollar aplicaciones de escritorio para Windows, trabajar con v a¬ 
rios conceptos de NET Framework y mucho más. 

El principal objetivo de este libro es el desarrollo NET usando C# como el 
lenguaje de implementación y el compilador de línea de comandos C# de NET 
Framework como la principal herramienta de desarrollo. El desarrollo de C# 


29 



empleando la herramienta Visual Studio .NET no se trata en este libro, aunque es 
algo que se puede dominar fácilmente una vez que se comprendan bien los fun¬ 
damentos del desarrollo NET usando C#. 


Quién debería leer este libro 


Este libro fue escrito teniendo en mente a los programadores novatos v los 
expertos. Si no conoce absolutamente nada sobre las bases del desarrollo de soft¬ 
ware. este libro le iniciara en sus fundamentos, mostrándole como funcionan las 
variables, los bucles de control y las clases. El libro también está dirigido a los 
programadores de cualquier nivel, mostrándoles las herramientas NET disponi¬ 
bles para el desarrollo en C# y proporcionándoles trucos para hacer que sus 
propias aplicaciones en C# funcionen perfectamente dentro de las directrices de 
desarrollo de NET Framework. 

Si ya esta introducido en el mundo de la creación de aplicaciones NET. en¬ 
contrará en este libro un recurso muy útil porque cubre casi todos los aspectos 
del desarrollo NET exhaustivamente. Las primeras tres partes del libro sirven 
de punto de referencia ilustrativo para usar las características del lenguaje CU. 
En cambio. las dos últimas partes están dedicadas a mostrar C# como plataforma 
de desarrollo de aplicaciones, ilustrando el papel de CU en aplicaciones de escri¬ 
torio. Web. bases de datos y basadas en componentes. En este libro se asume 
que es la primera vez que utiliza CU y pretende proporcionar una comprensión del 
lenguaje sin exigir un conocimiento previo. Sin embargo, el libro también supone 
que el lector está familiarizado con los entornos de aplicaciones usados en con¬ 
junción con sus aplicaciones C#. 

Las últimas partes del libro abordan el uso de C# con aplicaciones de escrito¬ 
rio. Web. bases de datos y basadas en componentes, pero no explica esas plata¬ 
formas con detalle. En su lugar, el libro supone que el lector tiene un conocimiento 
práctico de esas plataformas. 

Cómo está organizado este libro 


Este libro está organizado en seis partes: 

Parte I: Fundamentos del lenguaje C# 

Esta primera parte del libro proporciona una breve visión general de la familia 
de lenguajes de programación C y pasa a tratar los aspectos sintácticos básicos de 
CU. Variables, declaraciones, bucles de control de flujo y llamadas de método, 
todas son tratadas. Los programadores principiantes también encontrarán mate¬ 
rial explicativo sobre el uso de estos elementos sintácticos y aprenderán a elabo¬ 
rar código con estos conceptos. 
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Parte II: Programación orientada a objetos con C# 

Los capítulos de esta segunda parte tratan de la noción de clase en C#. La 
clase es la unidad fundamental de código en una aplicación C# y comprender las 
clases es clave para construir una aplicación C# que funcione. Ademas esta parte 
se ocupa de temas como el diseño de clases, clases básicas, clases derivadas y 
sobrecarga de operadores. 

Parte III: C# avanzado 

La tercera parte del libro se concentra en rasgos de lenguaje específicos em¬ 
pleados por aplicaciones C# más avanzadas. Se abordan temas como el control de 
excepciones, la implementación de interfaces, los espacios de nombre, los atribu¬ 
tos y el código no seguro, todos son tratados. El último capítulo de esta parte esta 
dedicado a presentar algunos problemas de programación complicados y solucio¬ 
nes aplicadas usando C#. 

Parte IV: Desarrollando soluciones .NET usando C# 

La parte IV muestra cómo usar C# en aplicaciones que utilizan varias partes 
de NET Framework. Esta parte del libro se separa de las otras secciones, que 
están dedicadas a la presentación de las características del lenguaje C#. La parte 
IV usa C# para construir aplicaciones usando varias plataformas de la aplicación 
NET. desde formularios de Windows hasta Web Forms y aplicaciones ASP.NET 
y acceso a bases de datos. También echaremos un vistazo al trabajo con algunas 
tecnologías .NET avanzadas usando C#. incluyendo subprocesamientos, ensam¬ 
blados y reflexión. 

Parte V: C# y .NET Framework 

La ultima parte del libro describe como se puede usar C# para trabajar con el 
propio NET Framework. Se explican conceptos de Framework tales como en¬ 
samblados. reflexión, subprocesamiento e interoperabilidad de componentes C OM 
COM + . Cada capítulo explica el concepto de Framework apropiado y también 
enseña a aprovechar la tecnología usando C# como lenguaje de implementa¬ 
ción. 

Parte VI: Apéndices 

La ultima sección del libro consta de dos apéndices: El primero ofrece una 
introducción al Lenguaje de marcado extensible (XML) y de qué manera los 
programadores pueden aprovechar este leguaje para describir datos de una ma¬ 
nera estandarizada. Muchos proyectos .NET usan XML de una forma u otra y 
varios archivos de configuración NET están basados en la infraestructura XML. 
El segundo apéndice incline una descripción del contenido del CD-ROM que 
acompaña al libro. 
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Cómo usar este libro 


Los lectores que sean completamente novatos en el desarrollo de software 
(quizas los administradores Web) aprovecharán mejor este libro leyendo primero 
las partes I v II para conseguir una mejor comprensión de como funcionan os 
mecanismos de una aplicación de software. Puede ser importante que los nuevos 
programadores comprendan las bases del desarrollo de software y como encajan 
todas las piezas para construir una aplicación CU completa 

A los lectores que se acerquen a C# con un conocimiento previo de C++ el 
nuevo lenguaje les resultara muy familiar CU fue construido pensando en C > 
CH y la sintaxis se parece a la de estos lenguajes mas antiguos. Estos lectores 
quizas deseen examinar las partes 1 y 11 para acostumbrarse a las vanantes de 
sintaxis v luego quizas deseen lanzarse de lleno a la parte III para comprender las 
avanzadas características del lenguaje. Muchos de los aspectos de la paite 
profundizan en los conceptos que distinguen CU de sus predecesores. 

Los programadores que ya estén familiarizados con CU encontraran bastante 
material útil. Las partes IV y V muestran el uso de CU en varias aplicaciones para 
la plataforma.NET y presentan varios ejemplos que explican el codigo C# que 
puede usarse para realizar tareas variadas. Estas dos ultimas partes trasladan e 
libro del nivel teórico al nivel practico y son ideales para los programadores de 
cualquier nivel que deseen comprender cómo puede usarse CU para implementai 

varias aplicaciones. 


Normas usadas en este libro 

A lo largo del libro encontrara unos rectángulos sombreados que resaltan la 
información especial o importante, estos son los siguientes: 

ADVERTENCIA: Indica un procedimiento que, en teoría, podría causar 
dificultades o incluso la pérdida de datos; preste especial atención a los 
iconos de advertencia para evitar los errores de programación mas comunes 
y los que no lo son tanto. _ 


NOTA: Resalta la información interesante o adicional y suele contener 
pequeños trozos extra de información técnica sobre un tema. 


TRUCO: Llaman la atención sobre hábiles sugerencias, pistas recomen 
dables y consejos útiles. 
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Además en este libro se usan las siguientes convenciones tipográficas: 

• Los códigos de ejemplo aparecen en un tipo de letra Courier. 

• Las opciones de menús se indican en orden jerárquico, con cada instruc¬ 
ción de menú separada por el signo "mayor que" y en un tipo de letra Anal. 
Por ejemplo. Archivo>Abrir quiere decir hacer clic en el comando Archi¬ 
vo en la barra de menú y luego seleccionar Abrir. 

• Las combinaciones de teclas se indican de esta forma: Control-C 

Al final de cada capítulo encontrará un resumen de lo que debería haber apren¬ 
dido al terminar de leer el capítulo. 
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Parte I 

Fundamentos 
del lenguaje C# 
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Introducción 

aC# 


Durante los últimos 20 años. C y C++ han sido los lenguajes elegidos para 
desarrollar aplicaciones comerciales y de negocios. Estos lenguajes proporcio¬ 
nan un altísimo grado de control al programador permitiéndole el uso de punteros 
\ muchas funciones de bajo nivel Sin embargo, cuando se comparan lenguajes, 
como Microsoft Visual Basic con C/C++. uno se da cuenta de que aunque C y 
C++ son lenguajes mucho más potentes, se necesita mucho más tiempo para 
desarrollar una aplicación con ellos. Muchos programadores de C/C++ han temi¬ 
do la idea de cambiar a lenguajes como Visual Basic porque podrían perder gran 
parte del control de bajo nivel al que estaban acostumbrados. 

Lo que la comunidad de programadores necesitaba era un lenguaje que estu¬ 
viera entre los dos. Un lenguaje que ayudara a desarrollar aplicaciones rápidas 
pero que también permitiese un gran control y un lenguaje que se integrase bien 
con el desarrollo de aplicaciones Web. XML y muchas de las tecnologías emer¬ 
gentes. 

Facilitar la transición para los programadores de C/C++ existentes y propor¬ 
cionar a la vez un lenguaje sencillo de aprender para los programadores inexper¬ 
tos son sólo dos de las ventajas del nuevo lenguaje del barrio. C#. Microsoft 
presentó C# al publico en la Prqfessional Developer's Conference en Orlando. 
Florida, en el verano del 2000. C# combina las mejores ideas de lenguajes como 
C. C++ y Java con las mejoras de productividad de NET Framework de Microsoft 
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y brinda una experiencia de codificación muy productiva tanto para los nuevos 
programadores como para los veteranos. Este capítulo profundiza en los cuatro 
componentes que constituyen la plataforma NET además de analizar la compati¬ 
bilidad para las tecnologías Web emergentes. A continuación, se analizan muchas 
de las funciones del lenguaje C# y se comparan con otros lenguajes populares. 


.NET Framework 


Microsoft diseñó C# desde su base para aprovechar el nuevo entorno NET 
Framework. Como C# forma parte de este nuevo mundo NET. deberá compren¬ 
der perfectamente lo que proporciona NET Framework y de que manera aumenta 
su productividad. 

NET Framework se compone de cuatro partes, como se muestra en la figura 
II; el entorno común de ejecución, un conjunto de bibliotecas de clases, un grupo 
de lenguajes de programación y el entorno ASP.NET. NET Framework fue dise¬ 
ñado con tres objetivos en mente. Primero, debía lograr aplicaciones Windows 
mucho más estables, aunque también debía proporcionar una aplicación con un 
mayor grado de seguridad. En segundo lugar, debía simplificar el desarrollo de 
aplicaciones v servicios Web que no sólo funcionen en plataformas tradicionales, 
sino también en dispositivos móviles. Por último, el entorno fue diseñado para 
proporcionar un solo grupo de bibliotecas que pudieran trabajar con vanos len¬ 
guajes. Las siguientes secciones analizan cada uno de los componentes de .NET 
Framework. 


Common Language Runtime 



Bibliotecas de Clase 


Lenguajes de Programación 
(C#, VC++, BV.NET. JScript.NET) 


ASP.NET 



Figura 1.1. Los cuatro componentes de NET Framework. 


Desarrollo Web 

NET Framework fue diseñado con una idea en mente: potenciar el desarrollo 
de Internet Este nuev o incentiv o para el desarrollo de Internet se llama servíaos 
Weh . Puede pensar en los serv icios Web como en una página Web que interactua 
con programas en lugar de con gente. En lugar de env iar páginas Web. un serv icio 
Web recibe una solicitud en formato XML. realiza una función en concreto > 
luego devuelve una respuesta al solicitante en forma de mensaje XML 
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NOTA: XML o el Lenguaje de marcado extensible es un lenguaje 
autodescriptivo muy parecido a HTML. Por otra parte, XML no consta de 
etiquetas predefinidas, lo que le concede una gran flexibilidad para repre¬ 
sentar una amplia variedad de objetos. 


Una típica aplicación para un servicio Web podría ser como capa situada en lo 
alto de un sistema de facturación de una empresa. Cuando un usuario que navega 
por la red compra los productos de una página Web. la información de la compra 
es enviada al servicio Web. que calcula el precio de todos los productos, añade 
una línea a la base de datos de existencias y devuelve una respuesta con una 
confirmación de pedido. Este servicio Web no sólo puede interactuar con páginas 
Web. puede interactuar con otros servicios Web. como un sistema de cuentas de 
pago de una empresa. 

Para que el modelo de servicio Web sobreviva a la evolución natural de los 
lenguajes de programación, debe incluir muchas más cosas que un simple interfaz 
para la Web. El modelo de servicio Web también incline protocolos que permiten 
que las aplicaciones encuentren servicios Web disponibles en una red interna o en 
Internet. Este protocolo también permite a la aplicación explorar el servicio Web 
y decidir cómo comunicarse con él y cómo intercambiar información. Para permi¬ 
tir el descubrimiento de servicios Web se estableció la Descripción, descubri¬ 
miento e integración universal (UDD1). Ésta permite que los servicios Web sean 
registrados y consultados, basándose en datos clave como el nombre de la com¬ 
pañía. el tipo de servicio y su localización geográfica. 

Desarrollo de aplicaciones 

Aparte del desarrollo Web. con NET Framework también puede construir las 
tradicionales aplicaciones Windows. Estas aplicaciones creadas con NET 
Framework se basan en Windows Forms. Windows Forms es una especie de cruce 
entre los formularios de Visual Basic 6 y los formularios de Visual C++. Aunque 
los formularios parecen iguales a sus predecesores, están completamente orienta¬ 
dos a objetos y basados en clases, de forma muy parecida a los formularios obje¬ 
to de Microsoft Foundation Class. 

Estos nuevos Windows Forms ahora admiten muchos de los controles clásicos 
que aparecían en Visual Studio. como Button. TextBox y Labe 1. junto a los 
controles ActiveX. Aparte de los controles tradicionales, también admite nuevos 
componentes como PrintPreview. LinkLabel. ColorDialog y 
OpenFileDialog. 

La creación de aplicaciones con NET también brinda muchas mejoras no 
disponibles en otros lenguajes, como la seguridad. Estas medidas de seguridad 
pueden determinar si una aplicación puede escribir o leer un archivo de disco. 
También permiten insertar firmas digitales en la aplicación para asegurarse de 
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que la aplicación fue escrita por una fuente de confianza. NET Framcwork tam¬ 
bién permite incluir información de componentes, y de versión, dentro del código 
real Esto hace posible que el software se instale cuando se lo pidan, 
automáticamente o sin la intervención del usuario. Juntas, todas estas funciones 
reducen los costes asistencia para la empresa. 

Entorno común de ejecución 


Los lenguajes de programación suelen componerse de un compilador y un 
entorno de ejecución. El compilador convierte el código que escribe en codigo 
ejecutable que puede ser ejecutado por los usuarios. El entorno de ejecución pro¬ 
porciona al código ejecutable un conjunto de servicios de sistema operativ o. Estos 
serv icios están integrados en una capa de ejecución de modo que el código no 
necesite preocuparse de los detalles de bajo nivel de funcionamiento con el siste¬ 
ma operativo. Operaciones como la gestión de memoria y la entrada y salida de 
archivos son buenos ejemplos de servicios realizados por un entorno de ejecu¬ 
ción 

Antes de que se desarrollara NET. cada lenguaje constaba de su propio entor¬ 
no de ejecución. Visual Basic consta de un tiempo de ejecución llamado 
MSVBVM 60 DLL Visual C++ utiliza una DLL llamada MSVC'RT DLL Cada 
uno de estos módulos de entorno de ejecución proporcionaba un conjunto de ser¬ 
vicios de bajo nivel para codificar lo que los programadores escribían Los pro¬ 
gramadores escribían código y luego lo compilaban con el apropiado tiempo de 
ejecución en mente El código ejecutable incluiría su propio tiempo de ejecución, 
que puede ser instalado en el equipo del usuario si aun no estaba presente. 

El principal problema que presentan estos entornos de ejecución es que esta¬ 
ban diseñados para usar un solo lenguaje. El tiempo de ejecución de Visual Basic 
proporcionaba algunas funciones estupendas para operaciones como trabajar con 
memoria e iniciar objetos COM. pero estas funciones estaban disponibles solo 
para los usuarios de Visual Basic. Los programadores que usaban Visual C++ no 
podían usar las funciones del tiempo de ejecución de Visual Basic. Los usuarios 
de Visual C++ tenían su propio tiempo de ejecución, con su propia larga lista de 
funciones, pero esas funciones no estaban disponibles para los usuarios de Visual 
Basic. Este enfoque de "tiempos de ejecución separados" impedía que los lengua¬ 
jes pudiesen funcionar conjuntamente sin problemas. No es posible, por ejemplo, 
tomar algo de memoria en un fragmento de código en Visual Basic y luego pasár¬ 
selo a una parte de codigo en Visual C++. lo que liberaría la memoria Los 
diferentes tiempos de ejecución implementan su propio conjunto de funciones a su 
manera. Los conjuntos de funciones de los diferentes tiempos de ejecución son 
inconsistentes. Incluso las funciones que se encuentran en mas de un tiempo de 
ejecución se implementan de diferentes formas, haciendo imposible que dos frag¬ 
mentos de codigo escritos en diferentes lenguajes trabajen juntos. 
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Uno de los objetivos de diseño de .NET Framework era unificar los motores 
de ejecución para que todos los programadores pudieran trabajar con un solo 
conjunto de servicios de ejecución. La solución de NET Framework se llama 
Entorno común de ejecución (CLR). El CLR proporciona funciones como la ges¬ 
tión de memoria, la seguridad y un sólido sistema de control de errores, a cual¬ 
quier lenguaje que se integre en NET Framework. Gracias al C ER. todos los 
lenguajes NET pueden usar varios servicios de ejecución sin que los programa- 
dores tengan que preocuparse de si su lenguaje particular admite una función de 
ejecución. 

El CLR también permite a los lenguajes interactuar entre sí. La memoria puede 
asignarse mediante código escrito en un lenguaje (Visual Basic NET . por ejemplo) 
v puede ser liberada con código escrito en otro (por ejemplo. C#). Del mismo 
modo, los errores pueden ser detectados en un lenguaje y procesados en otro. 


Bibliotecas de clase .NET 

A los programadores les gusta trabajar con codigo que ya ha sido probado y 
ha demostrado que funciona, como el API Win32 y la biblioteca de clase MFC. 
La reutilización del código lleva mucho tiempo siendo el objetivo de la comunidad 
de desarrolladores de software. Sin embargo, la posibilidad de reutilizar el codigo 
no ha estado a la altura de las expectativas. 

Muchos lenguajes han tenido acceso a cuerpos de codigo previamente com¬ 
probados v listos para ser ejecutado. Visual C++ se ha beneficiado de las biblio¬ 
tecas de clase, como las Clases de fundación Microsoft (MFC), que permitió a 
los programadores de C++ crear aplicaciones Windows rápidamente, y la Biblio¬ 
teca activa de plantillas (ATL). que proporciona ayuda para crear objetos COM 
No obstante, la naturaleza específica del lenguaje de estas bibliotecas las ha 
hecho inservibles para ser usadas en otros lenguajes. Los programadores de Vi¬ 
sual Basic tienen vetado el uso de ATL para crear sus objetos COM 

NET Framework proporciona muchas clases que ayudan a los programadores 
a reutilizar el codigo. Las bibliotecas de clase NET contienen código para pro¬ 
gramar subprocesos, entrada y salida de archivos, compatibilidad para bases de 
datos, análisis XML y estructuras de datos, como pilas y colas. Y lo mejor de 
todo, toda esta biblioteca de clase está disponible para cualquier lenguaje de 
programación compatible con NET Framework. Gracias al C LR. cualquier len¬ 
guaje .NET puede usar cualquier clase de la biblioteca NET. Como ahora todos 
los lenguajes admiten los mismos tiempos de ejecución, pueden reutilizar cual¬ 
quier clase que funcione con NET Framework. Esto significa que cualquier 
funcionalidad disponible para un lenguaje también estará disponible para cual¬ 
quier otro lenguaje NET 

El cuadro de reutilización de bibliotecas de clases dibujado por NET 
Framework se vuelve aún mejor cuando se da cuenta de que la reutilización se 
extiende a su código, no sólo al código que Microsoft lanza con NEd El código 
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de Microsoft sólo es código que fue escrito usando un lenguaje que NET admitía 
y se compilaba usando una herramienta de desarrollo .NET. Esto significa que 
Microsoft está usando las mismas herramientas que usará para escribir su códi¬ 
go. Puede escribir código capaz de ser usado en otros lenguajes NET. exacta¬ 
mente lo mismo que Microsoft con su biblioteca de clase. NET Framework permite 
escribir código en C#. por ejemplo, y env iárselo a programadores en Visual Basic 
NET. que pueden usar ese código que compiló en sus aplicaciones. La figura 1.2 
ilustra una visión muy general de las bibliotecas de clase .NET. 
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Description 
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Figura 1.2. Las bibliotecas de clase NET Framework 


Lenguajes de programación .NET 

NET Framework proporciona un conjunto de herramientas que le ayudan a 
elaborar código que funciona con .NET Framework. Microsoft proporciona un 
conjunto de lenguajes que ya son "compatibles con .NET". C# es uno de estos 
lenguajes. También se han creado nuevas versiones de Visual Basic v Visual 
C++ para aprovechar las ventajas de NET Framework y hay una versión de 
Jscript.NET en camino. 
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El desarrollo de lenguajes compatibles .NET no se limita a Microsoft. El gru¬ 
po NET de Microsoft ha publicado documentación que muestra cómo los provee¬ 
dores pueden hacer que sus lenguajes funcionen con NET. y estos proveedores 
están haciendo lenguajes como COBOL y Perl compatibles con NET Framcwork. 
Actualmente, una tercera parte de los proveedores e instituciones están preparan¬ 
do más de 20 lenguajes capaces de integrarse en NE I Framcwork. 

Entorno ASP.NET 

Internet fue concebida en un principio para enviar contenido estático a los 
clientes Web. Estas páginas Web nunca cambiaban y eran las mismas para todos 
los usuarios que navegaban hasta esa localización Microsoft lanzó servidores 
activos para permitir la creación de páginas dinámicas basadas en la aportación e 
interacción del usuario con una página Web. Esto se consiguió mediante el uso de 
secuencias de comandos que funcionaban por detras de la página Web. general¬ 
mente escritas en VB Script. Cuando los usuarios v isitaban una página Web. se 
les podía pedir que v erificasen la información (manualmente o con una cookie). y 
luego la secuencia de comandos podía generar una página Web que le era devuel¬ 
ta al usuario. 

ASP.NET mejora al original ASP proporcionando "código detras". En ASP. 
HTML v las secuencias de comando se mezclaban en un documento. C on ASP NEl 
V SU "codigo detrás", se puede separar el codigo y HTML Ahora, cuando la 
lógica de una página Web necesite cambiar, no hace falta buscar por cientos o 
miles de líneas de HTML para localizar la secuencia de comandos que necesita 
modificarse. 

De forma parecida a Windows Forms. ASP NET admite Web Forms Los Web 
Forms permiten arrastrar y colocar controles en sus formularios y codificarlos 
como haría en cualquier típica aplicación Windows. 

Como ASP.NET usa NET Framcwork. también usa el compilador Justo a 
tiempo (J1T) Las páginas ASP tradicionales se ejecutaban muy lentamente por¬ 
que el codigo era interpretado. ASP.NET compila el codigo cuando es instalado 
en el serv idor o la primera vez que es necesario, lo que aumenta enormemente la 
velocidad. 

Historia de C, C++ y C# 

El lenguaje de programación C# fue creado con el mismo espíritu que los 
lenguajes C v C++. Esto explica sus poderosas prestaciones y su fácil curva de 
aprendizaje. No se puede decir lo mismo de C y C++. pero como C# fue creado 
desde cero. Microsoft se tomo la libertad de eliminar algunas de las prestaciones 
más pesadas (cómo los punteros). Esta sección echa un v istazo a los lenguajes C 
v C++. siguiendo su evolución hasta C#. 
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El lenguaje de programación C fue diseñado en un principio para ser usado en 
el sistema operativo UNIX. C se usó para crear muchas aplicaciones UNIX, 
incluvendo un compilador de C. y a la larga se usó para escribir el mismo UNIX. 
Su amplia aceptación en el mundo académico se amplió al mundo comercial y los 
proveedores de software como Microsoft y Borland publicaron compiladores C 
para los ordenadores personales. El API original para Windows fue diseñado 
para trabajar con código Windows escrito en C y el último conjunto de API 
básicos del sistema operativo Windows sigue siendo compatible con C hoy en día. 

Desde el punto de vista del diseño. C carecía de un detalle que ya ofrecían 
otros lenguajes como Smalltalk: el concepto de objeto. Piense en un objeto como 
en una colección de datos y un conjunto de operaciones que pueden ser realizadas 
sobre esos datos La codificación con objetos se puede lograr usando C. pero la 
noción de objeto no era obligatoria para el lenguaje. Si quería estructurar su 
código para que simulara un objeto, perfecto. Si no. perfecto también. En realidad 
a C no le importaba. Los objetos no eran una parte fundamental del lenguaje, por 
lo que mucha gente no prestó mucha atención a este estándar de programación. 

Una vez que el concepto de orientación a objetos empezó a ganar aceptación, 
se hizo evidente que C necesitaba ser depurado para adoptar este nuevo modo de 
considerar al codigo. C++ fue creado para encarnar esta depuración. Fue diseña¬ 
do para ser compatible con el anterior C (de manera que todos los programas 
escritos en C pudieran ser también programas C’++ y pudieran ser compilados con 
un compilador de C++)- La principal aportación a C++ fue la compatibilidad 
para el nuevo concepto de objeto. C++ incorporó compatibilidad para clases (que 
son "plantillas" de objetos) y permitió que toda una generación de programadores 
de C pensaran en términos de objetos y su comportamiento. 

El lenguaje C++- es una mejora de C. pero aún así presenta algunas desventa- 
las. C v C++ pueden ser difíciles de manejar. A diferencia de lenguajes fáciles de 
usar como Visual Basic. C y C++ son lenguajes de muy "bajo nivel" y exigen que 
mucho código para funcionar correctamente. Tiene que escribir su propio codigo 
para manc|ar aspectos como la gestión de memoria y el control de errores. C \ 
C++ pueden dar como resultado aplicaciones muy potentes, pero debe asegurarse 
de que el código funciona bien. Un error en la escritura del programa puede hacer 
que toda la aplicación falle o se comporte de forma inesperada. Como el objetivo 
al diseñar C++ era retener la compatibilidad con el anterior C. C++ fue incapaz 
de escapar de la naturaleza de bajo nivel de C. 

Microsoft diseño C# de modo que retuviera casi toda la sintaxis de C y C++. 
Los programadores que estén familiarizados con esos lenguajes pueden escoger el 
código C# v empezar a programar de forma relativamente rápida. Sin embargo, la 
gran ventaja de C# consiste en que sus diseñadores decidieron no hacerlo compa¬ 
tible con los anteriores C y C'++. Aunque esto puede parecer un mal asunto, en 
realidad es una buena noticia. C’# elimina las cosas que hacían que fuese difícil 
trabajar con C y ('++. Como todo el código C es también código C++. C++ tenía 
que mantener todas las rarezas y deficiencias de C. C# parte de cero y sin ningún 
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requisito de compatibilidad, así que puede mantener los puntos fuertes de sus 
predecesores v descartar las debilidades que complicaban las cosas a los progra¬ 
madores de C v C++. 


Introducción a C# 


CU. el nuevo lenguaje presentado en NET Framevvork. procede de C++. Sin 
embargo, C# es un lenguaje orientado a objetos (desde el principio), moderno y 
seguro. 

Características del lenguaje 

Las siguientes secciones hacen un rápido repaso a algunas de las característi¬ 
cas de CU. Si no está familiarizado con alguno de estos conceptos, no se preocu¬ 
pe. Todos serán tratados con detalle en capítulos posteriores. 

Clases 

Todo el código y los datos en CU deben ser incluidos en una clase. No puede 
definir una variable fuera de una clase y no puede escribir ningún codigo que no 
esté en una clase. Las clases pueden tener constructores . que se ejecutan cuan¬ 
do se crea un objeto de la clase, y un destructor, que se ejecuta cuando un objeto 
de la clase es destruido. Las clases admiten herencias simples y todas las clases 
derivan al final de una clase base llamada objeto. CU admite técnicas de versio¬ 
nes para ayudar a que sus clases evolucionen con el tiempo mientras mantienen 
la compatibilidad con código que use versiones anteriores de sus clases. 

Por ejemplo, observe la clase llamada Family Esta clase contiene los dos 
campos estáticos que incluyen el nombre y el apellido de un miembro de la fami¬ 
lia junto con un método que devuelve el nombre completo del miembro de la 
familia. 

class Cíassi 

{ 

public string FirstName; 
public string LastÑame; 
public string FullName() 

{ 

return FirstName + LastName; 

} 

} 


NOTA: La herencia simple significa que una clase de C# sólo se puede 
derivar de una clase base. 
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C# 1c permite agrupar sus clases en una colección de clases llamada espacio 
de nombre. Los espacios de nombre tienen nombres y pueden servir de aviida 
para organizar colecciones de clases en agrupaciones lógicas. 

A medida que empieza a aprender C#. descubrirá que todos los espacios de 
nombre relevantes para NET Framevvork empiezan con el término System. 
Microsoft también ha decidido incluir algunas clases que ayudan a la compatibi¬ 
lidad con versiones anteriores y al acceso a los API. Estas clases se incluyen en el 
espacio de nombre Microsoft. 

Tipos de datos 

C# permite trabajar con dos tipos de datos: de valor y de referencia. Los de 
valor contienen valores reales. Los de referencia contienen referencias a valores 
almacenados en algún lugar de la memoria. Los tipos primitivos como char. 
int y float. junto con los valores y estructuras comentados, son tipos de 
valor. Los tipos de referencia tienen variables que tratan con objetos y matrices. 
C# viene con tipos de referencia predefinidos (object y string). junto con 
tipos de valor predefinidos (sbyte. short. int. long. byt.e. ushort. uint. 
uiong. float. double. bool. char y decimal). También puede definir 
en el código sus propios tipos de v alor y referencia. Todos los tipos de v alor v de 
referencia derivan en ultima instancia de un tipo base llamado object. 

C# le permite convertir un valor de un tipo en un valor de otro tipo. Puede 
trabajar con conversiones implícitas y explícitas. Las conversiones implícitas 
siempre funcionan y nunca pierden información (por ejemplo, puede convertir un 
int en un long sin perder ningún dato porque un long es mayor que un int). 
Las conversiones explícitas pueden producir perdidas de datos (por ejemplo, con¬ 
vertir un long en un int puede producir perdida de datos porque un long 
puede contener valores mayores que un int) Debe escribir un operador cast 
en el código para que se produzca una conversión explícita. 

En C# puede trabajar con matrices unidimensionales y multidimensionales. 
Las matrices multidimensionales pueden ser rectangulares, en las que cada una de 
las matrices tiene las mismas dimensiones, o escalonadas, en las que cada una de 
las matrices puede tener diferentes dimensiones. 

Las clases y las estructuras pueden tener miembros de datos llamados propie¬ 
dades y campos. Los campos son variables que están asociadas a la clase o 
estructura a la que pertenecen. Por ejemplo, puede definir una estructura llamada 
Empleado que tenga un campo llamado Nombre. Si define una variable de tipo 
Empleado llamada Emplea do Actual, puede recuperar el nombre del em¬ 
pleado escribiendo EmpleadoActual. Nombre. Las propiedades son como 
los campos, pero permiten escribir codigo que especifique lo que debería ocurrir 
cuando el codigo acceda al valor. Si el nombre del empleado debe leerse de una 
base de datos, por ejemplo, puede escribir código que diga "cuando alguien pre¬ 
gunte el valor de la propiedad Nombre, lee el nombre de la base de datos v 
devuelve el nombre como una cadena". 
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Funciones 

Una función es un fragmento de código que puede ser invocado y que puede 
o no devolver un valor al código que lo invocó en un principio. Un ejemplo de una 
función podría ser la función FullName mostrada anteriormente en este capítu¬ 
lo. en la clase Family. Una función suele asociarse a fragmentes de código que 
dev uelven información, mientras que un método no suele devolver información. 
Sin embargo, para nuestros propósitos, generalizamos y nos referimos a las dos 
como funciones. 

Las funciones pueden tener cuatro tipos de parámetros: 

• Parámetros de entrada: tienen valores que son enviados a la función, pero 
la función no puede cambiar esos valores. 

• Parámetros de salida: no tienen valor cuando son env iados a la función, 
pero la función puede darles un valor y env iar el valor de vuelta al invoca- 
dor 

• Parámetros de referencia: introducen una referencia en otro valor. Tienen 
un valor de entrada para la función y ese valor puede ser cambiado dentro 
de la función. 

• Parámetros Params: definen un numero variable de argumentos en una 
lista. 

C# v el CLR trabajan juntos para brindar gestión de memoria automática. No 
necesita escribir codigo que diga "asigna suficiente memoria para un numero 
entero" o "libera la memoria que está usando este objeto". El C LR monitoriza el 
uso de memoria v recupera automáticamente más cuando la necesita. También 
libera memoria automáticamente cuando detecta que ya no está siendo usada (esto 
también se conoce como recolección de objetos no utilizados). 

C# proporciona v arios operadores que le permiten escribir expresiones mate¬ 
máticas y de bits. Muchos (pero no todos) de estos operadores pueden ser 
redefinidos, permitiéndole cambiar la forma en que trabajan estos operadores. 

C ií admite una larga lista de expresiones que le permiten definir varias rutas de 
ejecución dentro del código. Las instrucciones de flujo de control que usan pala¬ 
bras clave como if. switch. while. for. break y continué permiten al 
código bifurcarse por caminos diferentes, dependiendo de los valores de sus va¬ 
riables. Las clases pueden contener código y datos. C ada miembro de una clase 
tiene algo llamado ámbito de accesibilidad . que define la visibilidad del miembro 
con respecto a otros objetos. C# admite los ámbitos de accesibilidad public. 
protected. interna!, protected internal y private. 

Variables 

Las variables pueden ser definidas como constantes. Las constantes tienen 
valores que no pueden cambiar durante la ejecución del codigo. Por ejemplo, el 
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valor de pi es una buena muestra de una constante porque el valor no cambia a 
medida que el codigo se ejecuta. Las declaraciones de Upo de enumeración espe¬ 
cifican un nombre de tipo para un grupo de constantes relacionadas Por ejemplo, 
puede definir una enumeración de planetas con valores de Mercurio. Venus. Tie¬ 
rra. Marte. Júpiter. Saturno. Urano. Neptuno y Plutón. y usar estos nombres en el 
codigo. Usando los nombres de enumeraciones en el código hace que sea más fácil 
leerlo que si usara un número para representar a cada planeta. 

CU incorpora un mecanismo para definir y procesar eventos. Si escribe una 
clase que realiza una operación muy larga, quizás quiera invocar un ex ento cuan¬ 
do la operación se complete. Los clientes pueden suscribirse a ese evento e in¬ 
cluirlo en el código, lo que permite que se les pueda avisar cuando ha\a acabado 
su operación El mecanismo de control de eventos en C# usa delegados, que son 
variables que se rctieren a una función. 


NOTA: Un controlador de eventos es un procedimiento en el código que 
determina las acciones que deben llevarse a cabo cuando ocurra un evento, 
como que el usuario pulse un botón. 


Si la clase contiene un conjunto de valores, los clientes quizás quieran acceder 
a los valores como s. la clase fuera una matriz. Puede conseguirlo escribiendo un 
fragmento de código conocido como indexador. Suponga que escribe una clase 
llamada Arcolris. por ejemplo, que contenga el conjunto de los colores del arco 
iris. Los visitantes querrán escribir MiArcoIris [ 0 ] para recuperar el primer 
color del arco iris. Puede escribir un indexador en la clase Arcolris para definir lo 
que se debe devolver cuando el visitante acceda a esa clase, como si fuera una 
matriz de valores. 

Interfaces 

CU admite interfaces, que son grupos de propiedades, métodos y eventos que 
especifican un conjunto de funcionalidad. Las clases CU pueden implementar 
interfaces, que informan a los usuarios de que la clase admite el conjunto de 
funcionalidades documentado por la interfaz. Puede desarrollar implementaciones 
de interfaces sin interferir con ningún código existente Una vez que la interfaz ha 
sido publicada, no se puede modificar, pero puede evolucionar mediante herencia. 
Las clases CU pueden implementar muchas interfaces, aunque las clases solo 
pueden derivarse de una clase base. 

Veamos un ejemplo de la vida real que puede beneficiarse del uso de interfaces 
para ilustrar su papel extremadamente positivo en CU. Muchas de las aplicacio¬ 
nes disponibles hoy en día admiten módulos complementarios. Supongamos que 
tiene un editor de código para escribir aplicaciones. Este editor, al ejecutarse, 
puede cargar módulos complementarios. Para ello, el módulo complementario 
debe seguir unas cuantas reglas. El módulo complementario de DLL debe expor- 
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tar una función llamada CEEntry y el nombre de la DLL debe empezar por 
CEd. Cuando ejecutamos nuestro editor de codigo. este busca en su directorio de 
trabajo todas las DLL que empiecen por CEd. Cuando encuentra una. la abre y a 
continuación utiliza GetProcAddress para localizar la función CEEntry 
dentro de la DLL. verificando así que ha seguido todas las reglas exigidas para 
crear un módulo complementario. Este método de creación y apertura de módulos 
complementarios es muy pesado porque sobrecarga al editor de codigo con mas 
tareas de verificación de las necesarias. Si usáramos una interfaz en este caso, la 
DLL del módulo complementario podría haber implementado una interfaz, garan¬ 
tizando así que todos los métodos necesarios, propiedades y eventos estén presen¬ 
tes en la propia DLL y que funciona como especifica la documentación. 

Atributos 

Los atributos aportan información adicional sobre su clase al CLR Antes, si 
quería que la clase fuera autodescriptiva. tenía que seguir un enfoque sin co¬ 
nexión. en el que la documentación fuera almacenada en archivos externos como 
un archivo IDL o incluso archivos HTML. Los atributos solucionan este proble¬ 
ma permitiendo al programador vincular información a las clases (cualquier tipo 
de información) Por ejemplo, puede usar un atributo para insertar información 
de documentación en una clase, explicando cómo debe actuar al ser usada Las 
posibilidades son infinitas y ésa es la razón por la que Microsoft incline tantos 
atributos predefinidos en NET Framework. 

Cómo compilar C# 

Ejecutar el código C# con el compilador de C# produce dos importantes con¬ 
juntos de información: el codigo y los metadatos. Las siguientes secciones descri¬ 
ben estos dos elementos y luego terminan examinando el componente esencial del 
código .NET: el ensamblado. 

Lenguaje intermedio de Microsoft (MSIL) 

El código generado por el compilador de C# está escrito en un lenguaje llama¬ 
do Lenguaje intermedio de Microsoft, o MSIL. MSIL se compone de un conjunto 
específico de instrucciones que especifican cómo debe ser ejecutado el codigo. 
Contiene instrucciones para operaciones como la inicialización de variables, los 
métodos de llamada a objetos y el control de errores, por citar solo unos pocos. 
C# no es el único lenguaje cuyo código fuente se transforma en MSIL durante el 
proceso de compilación. Todos los lenguajes compatibles con .NET. incluido Vi¬ 
sual Basic .NET y C++ gestionado, producen MSIL cuando se compila su codigo 
fuente. Como todos los lenguajes .NET se compilan en el mismo conjunto de 
instrucciones MSIL. y como todos los lenguajes NET usan el mismo tiempo de 
ejecución, los códigos de diferentes lenguajes y de diferentes compiladores pue¬ 
den funcionar juntos fácilmente. 
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MSIL no es un conjunto de instrucciones específicas para una CPU física. 
MSIL no sabe nada de la CPU de su equipo y su equipo no conoce nada de MSIL 
Entonces, ¿cómo se ejecuta el codigo .NET. si su CPU no lo puede interpretar? La 
respuesta es que el código MSIL se convierte en código específico de CPU cuando 
se ejecuta por primera vez. Este proceso se llama compilación "Justo a tiempo" o 
JIT. El trabajo de un compilador JIT es convertir el código genérico MSIL en 
codigo que su equipo pueda ejecutar en su CPU. 

Quizas se esté preguntando por lo que parece ser un paso innecesario en el 
proceso. í( Por qué generar MSIL cuando un compilador podría generar directa¬ 
mente código específico para la CPU 9 

Después de todo, los compiladores siempre lo han hecho en el pasado. Hav un 
par de razones que lo explican. En primer lugar. MSIL permite que el codigo 
compilado se transfiera fácilmente a hardware diferente. Suponga que ha escrito 
algo de codigo C# y le gustaría ejecutarlo en su ordenador personal y en su 
dispositivo portátil. Es muy probable que estos dos equipos tengan diferentes 
CPU. Si sólo tiene un compilador de C# para una CPU específica, entonces nece¬ 
sita dos compiladores de C#: uno para la CPU de su ordenador personal y otro 
para la CPU de su dispositivo portátil. Tendría que compilar el código dos veces, 
asegurándose de poner el codigo adecuado para cada equipo. Con MSIL. solo se 
compila una vez. 

Al instalar NET Framework en su ordenador personal se incline un compilador 
JIT qu e convierte el MSIL en código específico para la CPU de su ordenador 
personal. Al instalar NET Framework en su ordenador portátil se incline un 
compilador JIT que convierte el mismo MSIL en código especifico para la CPU 
de su dispositivo portátil. Ahora tiene un solo código base MSIL que puede eje¬ 
cutarse en cualquier equipo que tenga un compilador JIT NET. El compilador 
JIT en ese equipo se ocupa de hacer que el codigo se ejecute. 

Otra razón para que el compilador use MSIL es que el conjunto de instruccio¬ 
nes puede leerse fácilmente por un proceso de verificación. Parte del trabajo del 
compilador JIT es verificar el codigo para asegurarse de que resulte lo mas claro 
posible. El proceso de verificación asegura que el código accede a la memoria 
correctamente y de que esta usando los tipos de variable correctos al llamar a 
métodos que esperan un tipo específico. Estos procesos de v erificación se asegu¬ 
ran de que el codigo no ejecute ninguna instrucción que origine un fallo. El con¬ 
junto de instrucciones MSIL fue diseñado para hacer este proceso de verificación 
relativamente sencillo Los conjuntos de instrucciones específicos para cada CPU 
están optimizados para la rápida ejecución del codigo. pero producen código que 
puede ser difícil de leer y. por tanto, de v erificar. Tener un compilador de C# que 
produce directamente codigo específico para CPU puede hacer difícil la verifica¬ 
ción del código, o incluso imposible. Al permitir al compilador JIT de .NET 
Framework que v erifique el código se asegura de que el código acceda a la memo¬ 
ria en un modo libre de fallos y que los tipos de variable sean usados correcta¬ 
mente. 
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Metadatos 


El proceso de compilación también produce metadatos. lo que es una parte 
importante de la historia de como se comparte el codigo NET Tanto si usa C# 
para construir una aplicación para un usuario final como si lo usa para construir 
una biblioteca de clases que sera usada por la aplicación de alguna otra persona, 
querrá usar codigo NET ya compilado. Ese código puede ser proporcionado por 
Microsoft como parte de NET Framevvork. o por un usuario a través de Internet 
La clave para usar este codigo externo es hacer que el compilador de C# sepa que 
clases v variables están en el otro codigo base para que pueda comparar el codigo 
fuente que ha escrito con el codigo que aparece en el codigo base precompilado 
con el que esta trabajando. 

Piense en los metadatos como en "tablas de contenidos" para el codigo compi¬ 
lado. El compilador de C# coloca metadatos en el codigo compilado junto al 
MSIL generado. Este metadato describe con exactitud todas las clases que escri¬ 
ba v cómo están estructuradas. Todos los métodos y variables de las clases están 
completamente descritos en los metadatos. listos para ser leídos por otras aplica¬ 
ciones. Visual Basic .NET. por ejemplo, puede leer los metadatos para que una 
biblioteca NET proporcione la función IntelliSense de listar todos los métodos 
disponibles para una clase en concreto. 

Si alguna vez ha trabajado con ( OM (Modelo de objetos componentes), qui¬ 
zas este familiarizado con las bibliotecas de tipos. Las bibliotecas de tipos tratan 
de proporcionar una funcionalidad "de tabla de contenidos" similar para objetos 
C OM Sin embargo, las bibliotecas de tipos presentaban algunas limitaciones, 
una de las cuales consistía en que no se incluian todos los datos importantes 
relacionados con el objeto. Los metadatos de.NET no presentan este inconve¬ 
niente. Toda la información necesaria para describir una clase en un código esta 
situada en el metadato. Los metadatos tienen todas las v entajas de las bibliotecas 
de tipos COM. pero sin sus limitaciones. 

Ensamblados 

A veces usará C# para construir una aplicación para un usuario final Estas 
aplicaciones se presentan como archiv os ejecutables con extensión EXE Windows 
siempre ha trabajado con archivos EXE como programas de aplicación y C# 
admite a la perfección la construcción de archivos .EXE 

Sin embargo, puede haber ocasiones en las que no quiera construir una aplica¬ 
ción completa. Quizás quiera construir en su lugar una biblioteca de código que 
pueda ser usada por otras personas. Quizás también quiera construir algunas 
clases de utilidad, por ejemplo, y luego transferir el código a un programador de 
Visual Basic NET. que usara sus clases en una aplicación de Visual Basic NE Y 
En casos como este, no construirá una aplicación, sino un ensamblado. 

Un ensamblado es un paquete de codigo y metadatos. C uando utiliza un con¬ 
junto de clases en un ensamblado, está usando las clases como una unidad y estas 
clases comparten el mismo niv el de control de versión, información de seguridad 
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y requisitos de activación. Imagine un ensamblado como una "DLL lógica". Si no 
está familiarizado con Microsoft Transaction Server o COM+. puede imaginar un 
ensamblado como el equivalente .NET de un paquete. 

Hav dos tipos de ensamblados: ensamblados privados y ensamblados globales. 
Al construir el ensamblado, no necesita especificar si quiere construir un ensam¬ 
blado privado o global. La diferencia es ostensible cuando se implementa el en¬ 
samblado. Con un ensamblado privado, hace que el código esté disponible para 
una sola aplicación. El ensamblado se empaqueta como una DLL y se ínstala en el 
mismo directorio que la aplicación que lo está usando. Con el uso de un ensam¬ 
blado privado, la única aplicación que puede usar el código es el ejecutable situa¬ 
do en el mismo directorio que el ensamblado. 

Si quiere compartir el código con varias aplicaciones, quizás quiera considerar 
el uso del codigo como ensamblado global. Los ensamblados globales pueden ser 
usados por cualquier aplicación NET en el sistema, sin importar el directorio en 
el que este instalada. Microsoft incorpora ensamblados en NET Framework y 
cada uno de los ensamblados de Microsoft se instala como ensamblado global. 
NET Framework contiene una lista de ensamblados globales en un servicio lla¬ 
mado caché de ensamblado global y el SDK de .NET Microsoft Framework 
incluye utilidades para instalar y eliminar ensamblados de la cache de ensambla¬ 
do global 

Resumen 

En este capítulo se han explicado las bases de NET Framework. Tras seguir 
la evolución desde C aC++ v hasta C#. se han examinado los puntos fuertes de 
la lista de prestaciones de C#. También se ha investigado el producto del 
compilador de C#. el código MSIL y los metadatos. y se ha revisado el uso de 
ensamblados como los bloques de construcción esenciales del código NET com¬ 
pilado. 
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2 


Escribir 


su primer 
programa en C# 


Este capítulo le guía a través del desarrollo de una sencilla aplicación de C#. 
También aprenderá cómo están estructuradas las aplicaciones C# más sencillas 
v cómo invocar al compilador de C# para convertir el código fuente en código 
que puede ser ejecutado por .NET Framcwork. Finalmente, aprenderá a docu¬ 
mentar el código empleando comentarios de código fuente y cómo convertir 
automáticamente sus comentarios en un documento XML. 


Cómo escoger un editor 

A la hora de escribir código para NET Framcwork en C# tiene varias opcio¬ 
nes. La elección más lógica es usar Visual Studio NET. Usando Visual Studio. 
dispone de todas las ventajas de la tecnología IntclliSense. el marcado de sintaxis 
v muchas otras herramientas que aumentan la productividad. 

Muchos editores de terceros intentan aunar en un paquete las herramientas de 
producción de Visual Studio. Algunas de estas herramientas pueden ser descarga¬ 
das como Shareware y otras son de libre distribución. Los ejemplos de este capí¬ 
tulo usan sencillamente el Bloc de notas de Windows. Al usar el Bloc de notas, no 
sólo demostramos que se puede usar cualquier editor de texto para escribir aplica- 
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ciones en C#. sino que también servirá para aprender las bases necesarias para 
compilar aplicaciones. 

Ademas, el uso del Bloc de notas servirá para demostrarle que no necesita 
confiar en ningún asistente para generar el código. Puede simplemente concen¬ 
trarse en el lenguaje mismo, sin tener que aprender los detalles de un IDE. Sin 
embargo, tenga en cuenta que para las aplicaciones más grandes quizás prefiera 
usar un editor que muestre los números de linea, lo que puede ser muv útil cuando 
se está buscando codigo defectuoso. 

La aplicación Helio World 


El codigo que se muestra en el listado 2.1 es una aplicación de C# completa. Se 
ejecuta desde una ventana de la consola y presenta el mensaje Helio World 1 en la 
pantalla. Las siguientes secciones siguen este código línea a línea. 

Listado 2.1. Cómo escribir en la consola 

cías s H e 1 i 0 W 0 r 1 el 
{ 

public static void Main() 

{ 

System. Consolé .WnteLine ( "Helio World ! " ) ; 



Cómo construir una clase 

La primera línea del programa C# define una clase. Una clase es un recipiente 
para todo el código de la aplicación. 

A diferencia de C y C++. todo el código debe estar contenido en una clase, con 
escasas excepciones. Estas excepciones a la regla son la instrucción using. las 
declaraciones de estructuras y la declaración namespace. Cualquier intento de 
escribir codigo que no este contenido en una clase da como resultado un error de 
compilación. 

La primera línea de la aplicación Helio World empieza con la palabra clave 
class y. a continuación, la palabra Hel/oWorld. He/loWorld es el nombre de la 
clase que el codigo está creando. Cada clase debe tener asignado un nombre único 
para que luego pueda referirse a ellas. 

Inmediatamente después de la declaración de clase se debe abrir una llave. La 
llave de apertura se usa para abrir el cuerpo de la clase del código. Todo el código 
que escriba en la clase debe incluirse después de esta llave de apertura. Ademas 
de la llave de apertura, también debe haber una llave de cierre, como la que 
aparece en la última línea de la aplicación Hel/oWorld. Asegúrese de que toda su 
programación este entre estas dos llaves. 
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El método Main() 

Todas las aplicaciones escritas en C# deben constar de un método llamado 
Main ( ) . Un método es un conjunto de instrucciones que realizan una acción. 
Este método puede devolver información a la sección de código que lo llamó pero 
en determinadas circunstancias no es necesario que lo haga. 


NOTA: Los términos método y función suelen usarse de forma indistinta, 
pero hay una diferencia. Un método es una función contenida en una clase. 
Una función suele ser un grupo de instrucciones que no está contenido en 
una clase y que suele estar en un lenguaje, como C o C++. Como en C# no 
se puede añadir código fuera de una clase, nunca tendrá una función. 


La palabra clave public en la declaración del método Main ( ) también 
contiene la palabra public. que informa al compilador de que el método Main () 
debe ser públicamente accesible. El método Main { ) no sólo es accesible por 
otros métodos desde dentro de la aplicación, sino también externamente por otras 
aplicaciones. Al declarar el método Main ( ) como publico, está creando un pun¬ 
to de entrada para que Windows inicie la aplicación cuando un usuario lo desee. 

Cuando un usuario haga doble clic sobre el icono de la aplicación HelloWorki. 
Windows explorará el ejecutable en busca de un punto de entrada con ese nombre. 
Si no encuentra una entrada, la aplicación no podrá ejecutarse. 

La palabra Static en la declaración del método significa que el compilador 
sólo debe permitir que exista en memoria una copia del método por vez. Como el 
método Main ( ) es el punto de entrada a la aplicación, sería catastrófico permitir 
que el punto de entrada se abriese más de una vez ya que permitiría más de una 
copia de la aplicación en memoria e. indudablemente, algunos errores graves. 

Justo antes de la palabra Main, verá la palabra Void. Void es lo que la 
función principal devuelve cuando ha completado su ejecución. Significa que la 
aplicación no devuelve ningún valor después de haberse completado. Esta aplica¬ 
ción de ejemplo no es muy avanzada, así que no necesita devolver ningún valor. 
Sin embargo, en circunstancias normales, la función Main ( ) devolvería un valor 
entero reemplazando la palabra void por int . Valores de devolución válidos 
son cualquier tipo de dato simple definido en .NET Framework. 

De forma muy parecida a una declaración de clase, cualquier método que 
defina debe también contener una llave de apertura y otra de cierre entre las que 
se debe colocar todo el código del método. Puede ver las llaves de apertura y de 
cierre para el método Main ( ) en las líneas 4 y 6 en el listado 2.1 

Cómo escribir en la consola 

La linca 5 del listado 2.1 contiene una llamada al método WriteLine. Este 
método está contenido en NET Framework y escribe una cadena en la consola. Si 
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se ejecuta desde una ventana de la consola, el texto debería aparecer en la panta¬ 
lla. Si ejecuta este comando desde un entorno de Visual Studio. cualquier resulta¬ 
do que produzca aparecerá en la ventana de salida. 

Ya hemos aprendido que todas las funciones de CU deben ser definidas den¬ 
tro de una clase. Las funciones de .NET Framework no son una excepción La 
función WriteLine ( ) se encuentra en una clase llamada Consolé. La pala¬ 
bra clave Consolé, usada justo antes de la llamada a la función WriteLine ( ) . 
indica al compilador que la función WriteLine ( ) se encuentra en una clase 
llamada Consolé. La clase Consolé es una de las muchas clases de .NET 
Framework y la función WriteLine { ) es un miembro de la clase Consolé. 
El nombre de la clase está separado del nombre de la función que se invoca por 
medio de un punto. 

El nombre System aparece inmediatamente antes del nombre de clase 
Consolé. Las clases de.NET Framework están organizadas en grupos llama¬ 
dos espacios de nombre. Los espacios de nombre se explican con más detalle en 
un capítulo posterior. Por ahora, piense en los nombres de espacios como en una 
colección de elase. La clase Consolé se encuentra en un espacio de nombre de 
NET Framework llamado System y debe escribir el nombre de este espacio de 
nombre en el codigo. El compilador de CU necesita encontrar el codigo de 
WriteLine ( ) para que la aplicación se ejecute correctamente y debe dar al 
compilador suficiente información sobre los espacios de nombre y las clases an¬ 
tes de encontrar el código de WriteLine ( ) . 

El texto que se incline dentro de los paréntesis de WriteLine ( ) es una 
cadena. Una cadena en CU es una colección de caracteres encerrados entre comi¬ 
llas y guardados juntos como unidad. Al colocar la cadena entre los paréntesis se 
indica al compilador que queremos pasar la cadena como parámetro de la función 
WriteLine ( ) . La función WriteLine () escribe una cadena en la consola v 
el parámetro de la función indica a WriteLine ( ) qué cadena debe escribirse. 

La línea 5 incluye una gran cantidad de información que puede interpretarse 
de la siguiente forma: "Compilador CU. quiero llamar a WriteLine ( ) con el 
parametro de cadena Helio Work! r La función WriteLine ( ) se incline en 
una elase llamada Consolé y la clase Consolé se incline en un espacio de 
nombre llamado System. La línea 5 termina con un punto y coma. Todas las 
instrucciones deben terminar con un punto y coma. El punto v la coma separan 
una instrucción de otra en CU. 

Compilación y ejecución del programa 

Ahora que ya ha revisado el codigo del listado 2.L es hora de ejecutarlo. 
Escriba el código del listado 2.1 en su editor de texto favorito y guárdelo como un 
archivo llamado listado 2.1. es. La extensión es es la extensión de todos 
los archivos que contienen codigo CU. 
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NOTA: Antes de compilar el ejemplo en C#, debe asegurarse de que el 
compilador de C# esté en su Path. La aplicación csc.exe generalmente 
está en la carpeta C:\Windows\Microsoft.NET\Framework\ 
vi. 0 . xxxx (reemplace Vl.O.Xxxx con su versión de .NET Framework), 
lo que puede comprobar buscándola en Windows. Para añadir entradas a su 
ruta, busque en la Ayuda de Windows la palabra Path. 


A continuación abra un símbolo de comandos y diríjase a la carpeta en la que 
guardó el archivo HelloWorld.es. Una vez allí, puede escribir el siguiente 
comando: 

csc HelloWorld.es 

El comando csc invoca al compilador CU de NET Framework. Al ejecutar 
este comando se genera un ejecutable llamado HelloWorld . eze. que puede 
ser ejecutado exactamente igual que cualquier aplicación de Windows. Si ejecuta¬ 
mos este archivo, se escribirá texto en la ventana de la consola tal y como se 
muestra en la figura 2.1. 


c v C:\WIND0WS\System32\cmd.eHe 

C:\»ie lio world 
Helio Uoivld! 

C:\> 


ITc- 


^IPJüí 


Id 


Figura 2.1. La ventana emergente de comando muestra la aplicación Helio World 

en acción 


¡Enhorabuena! Acaba de escribir su primera aplicación de CU. 


Las palabras clave y los identificadores 

La aplicación de CU del listado 2.1 contiene muchas palabras, separadas por 
espacios. En ella, se utilizan dos tipos de nombres: palabras clave e identificadores. 
Esta sección describe las diferencias entre estos dos tipos de nombres. 

Las palabras clave son palabras que tienen un significado especial en el len¬ 
guaje CU. Estas palabras han sido reservadas en CU y nos referimos a ellas como 
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palabras reservadas. Las palabras class. static y void son las palabras 
reservadas del listado 2.1. Cada palabra clave posee en el lenguaje CU un signifi¬ 
cado especial. La siguiente lista contiene todas las palabras clave definidas en 

CU. 


abs t ra ct 

enum 

1 ong 

stackalloc 

a s 

e ven t 

namespace 

static 

base 

explicit 

new 

s t ring 

boo 1 

e z tern 

nuil 

stru c t. 

break 

f a 1 s e 

ob j ect 

switch 

b y t e 

f i n a 11 y 

ope rato r 

this 

c ase 

f i z e d 

out 

throw 

c a t c h 

f i o a t 

override 

t rué 

c h a r 

for 

pa rams 

t r y 

c h e o k e d 

f o r e a o h 

priva te 

typeo f 

c lass 

goto 

p r o t e c t e d 

u i n t 

c o n s t 

i f 

public 

ulong 

continué 

imp1ic i t 

readonly 

unchecke el 

decima 1 

i n 

re f 

unsafe 

de fault 

int 

retu rn 

us hort 

delegate 

interface 

sby t e 

us ing 

do 

internal 

sealed 

virtual 

doub ] e 

i s 

short 

vo i d 

el s e 

lock 

siceof 

while 


Los identifícadores son los nombres que se usan en las aplicaciones. CU no 
reseñ a nombres de identificadores. Los identificadores son palabras que designan 
objetos en el código CU. Su clase necesita un nombre v se ha usado el nombre 
HelIoWor/dpaYa su clase Hsto convierte al nombre HelIoWorld en un identificado!* 
Su método también necesita un nombre y se ha usado el nombre Mam para su 
función Esto convierte al nombre Mam en un identificado!*. El compilador de CU 
no permite normalmente usar ninguna de las palabras clave reservadas como nom¬ 
bres de identificador. Obtendrá un error si. por ejemplo, intenta aplicar el nombre 
static a una clase. Sin embargo, si realmente necesita usar el nombre de una 
palabra clave como identificador. puede poner delante del identificador el símbolo 
a . Esto invalida el error del compilador y permite usar una palabra clave como 
identiíícador. El listado 2.2 muestra como hacerlo. Es una modificación del codigo 
del listado 2.1 y define la palabra virtual como el nombre de la clase. 
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Listado 2.2. Cómo usar la palabra clave virtual como identificador de clase 


class ©virtual 
{ 

static void Main () 

{ 

System-Consolé.WriteLine{"Helio World!"); 



Sin el precedente símbolo a . obtendría un error del compilador, como el que 
se muestra en la figura 2.2. 



Figura 2.2. Si olvida el símbolo @ el compilador generará errores 


Uso de espacios en blanco 

El texto de las aplicaciones C# puede incluir espacios, tabulaciones y caracte¬ 
res de retorno. Estos caracteres son llamados caracteres ele espacio en blanco. 
Los caracteres de espacio en blanco, que pueden ser colocados en cualquier lugar 
excepto en medio de una palabra clave o un identificador. ayudan a mejorar la 
legibilidad del código. 

El compilador de C# pasa por alto la colocación de espacios en blanco cuando 
compila un programa. Esto significa que puede colocar cualquier carácter de 
espacio en blanco en cualquier lugar donde el compilador acepte un carácter de 
espacio en blanco. El compilador pasa por alto el uso de caracteres de retorno, 
tabulaciones y espacios. Puede usar cualquier combinación de espacios en blanco 
que desee en su código. 

Los listados de este libro muestran estilos personales de colocación de espa¬ 
cios en blanco: los retornos están colocados antes y después de las llaves de 
apertura v cierre, v el código está sangrado a partir de las llaves. Sin embargo, no 
es obligatoria esta disposición en las aplicaciones C#. El listado 2.3 muestra una 





disposición alternativa del codigo usando caracteres de espacio en blanco dife¬ 
rentes. No tema experimentar con el estilo que más le guste. 

Listado 2.3. Una disposición de espacios en blanco alternativa 


C 1 a s s 

He 1 1oWor1d 
{ 

.star i c vo id Mam f) 

{ 

.System. Consol e . WriteLi ne (' "Helio World ! " ) ; 

} 

} 


Si compila y ejecuta el listado 2.3. verá que se comporta exactamente igual 
que el codigo del listado 2.1: produce la cadena "Helio World 1 ". La nueva dispo¬ 
sición de espacios en blanco no tiene ningún efecto en el comportamiento del 
codigo que se ejecuta en el tiempo de ejecución. 

Cómo iniciar programas con la función Main() 


La aplicación que se muestra en el listado 2.1 define una clase con una función 
llamada Main(). La función Main ( ) es una parte importante de las aplicaciones 
CU. ya que es donde comienza a ejecutarse nuestro programa. Todas las aplica¬ 
ciones escritas en CU deben tener una clase con una función llamada Main j ) . 
La función Main ( ) es conocida como el punto de entrada de sus aplicaciones \ 
la ejecución de sus aplicaciones CU empieza con el código en Mai n ( ) . Si el 
código contiene mas de una clase, solo una de ellas puede tener una función 
llamada Ma i n ( ) . Si olvida definir una función Ma i n ( ) . recibirá varios mensa¬ 
jes de error por parte del compilador, como se muestra en la figura 2.3. 




-=JEJ xj 


C:\>csc HelloUorld.es 

Compilador de Microsoft <R> Uisual Ctt .NET versión 7.00.9466 
para Microsoft <R> .NET Framework versión 1.0.3705 

<C) Microsoft Microsoft Corporation 2001. Reservados todos los derechos. 

HelloUorId.es<3,5>: error CS1520: Una clase, una estructura o un método de 
interfaz debe tener un tipo de valor devuelto 


Ld 


Figura 2.3. La ausencia de una función Main () produce errores de compilación 
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La función Main ( ) definida en el listado 2.1 no devuelve nada (de ahi la 
palabra clave void) y no toma argumentos (de ahí los paréntesis vacíos). El 
compilador C#. de hecho, acepta cualquiera de las cuatro posibles construcciones 
de la función Main ( ) : 


• public 

static 

void 

Main { ) 


• public 

static 

void 

Main(string 

[ ] Arguments) 

• public 

static 

int 

Main { ) 


• public 

static 

int 

Main(string 

'.|] Arguments) 

La primera variante, public 

static void 

Main ( ). es la forma usada 


en el listado 2.1. 

La segunda, public static void Main ( st ring [ ] Arguments). 

no devuelve un valor al que la llama. Sin embargo, toma una matriz de cadenas. 
Cada cadena de la matriz se corresponde a un argumento de la línea de comando 
suministrado al ejecutar el programa. Por ejemplo, suponga que modifica el códi¬ 
go del listado 2.1 para que el método Main { ) acepte una matriz de cadenas 
como argumento. Además, suponga que ejecuta ese codigo y suministra algunos 
argumentos de línea de comandos: 

Listing2-l.exe Paraml Param2 Param3 

En este caso, la matriz de cadenas que se pasa a la función Main ( ) tiene los 
siguientes contenidos: 

Arguments [0] : Paraml 

Arguments [1] : Param2 

Arguments [2] : Param3 

La tercera variante, public static int Main ( ) . devuelve un valor 
entero. Que el valor que se dev uelve sea entero se especifica mediante la palabra 
clave int de la declaración. Los valores enteros devueltos por Main ( ) se usan 
como códigos de fin de programa. Por ejemplo, suponga que desea diseñar sus 
aplicaciones para que dev uelvan un valor (supongamos 0) si la operación resulta 
satisfactoria v otro valor (supongamos 1) si la operación no se cumple. Si ejecuta 
la aplicación .NET desde un entorno que puede leer este código de terminación de 
programa, tiene suficiente información para determinar si el programa se ejecuto 
satisfactoriamente. La última variante de la función Main { ) . public static 
int Main ( string [ ] Arguments ). especifica una función que propor¬ 
ciona argumentos de línea de comando en una matriz de cadenas y permite a la 
función dev olv er un código de terminación de programa. 

Debe tener presente algunas cosas cuando trabaje con la función Main ( ) : 

• Las formas de devolución void de la función Main ( ) siempre tienen 
un código de terminación de programa de 0. 
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• La palabra clave static es necesaria en todas las variantes de la fun¬ 
ción Main ( ) . 

Cuando se ejecuta una aplicación de C#, el usuario siempre proporciona los 
argumentos de la línea de comando. Sin embargo, si la aplicación de C# esta 
escrita con una de las variantes de la función Main ( ) que no toma argumentos, 
la aplicación sera incapaz de leerlos. Esta permitido que el usuario especifique 
argumentos en una aplicación de C# que no fue escrita para admitirlos (aunque 
no sera muy útil). 


Cómo comentar el código 

Comentar el codigo le permite añadir notas a sus archivos fuente de C#. Estas 
notas pueden ayudarle a documentar el diseño y el funcionamiento de la aplica¬ 
ción. Puede colocar comentarios en cualquier parte del código fuente de C# donde 
sea posible usar espacios en blanco. 

Cómo usar comentarios de una línea 

Los comentarios de una línea empiezan con dos barras inclinadas y afecta al 
resto de la línea: 

{ // esto es una llave de apertura 

System. Consolé . Wr iteLine ( "C# ") ; // cali WriteLme () 

} // esto es una llave de cierre 

Usar comentarios regulares 

Los comentarios regulares empiezan con una barra inclinada seguida de un 
asterisco y su efecto permanece hasta que encuentra un asterisco seguido por una 
barra inclinada. Los comentarios regulares pueden extenderse por varias líneas: 

/* 

Esto es un comentario regular de C#. 

Contiene varias lineas de texto, 

Separadas por caracteres NewLine. 

V 

El compilador de C# no permite incrustar un comentario regular en otro: 

/* 

comentario externo 
/* 

comentario interno 
*/ 

mas texto de comentario externo 

V 
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No puede incrustar un comentario regular en otro porque el compilador en¬ 
cuentra los primeros caracteres */ y da por hecho que ha alcanzado el final del 
comentario de varias lincas. A continuación, supone que el siguiente texto segui¬ 
do por los caracteres es código fuente de C# e intenta interpretarlo como tal. 

Sin embargo, puede incrustar un comentario de una sola línea en un comenta¬ 
rio regular: 

/* 

comentario externo 

// comentario interno 
más texto de comentario externo 
*/ 

Cómo generar documentación XML a partir de 
comentarios 

Una característica interesante del compilador de C# es que puede leer comen¬ 
tarios en un formato especial y generar documentación XML a partir de los co¬ 
mentarios. Puede entonces colocar este XML en la Web para facilitar un nivel 
extra de documentación a los programadores que necesiten comprender la estruc¬ 
tura de sus aplicaciones. 

Para usar esta función, debe hacer dos cosas: 

• Usar tres barras inclinadas para los comentarios. El compilador de C# no 
genera ninguna documentación XML para ningún documento que no em¬ 
piece con tres barras. Tampoco genera documentación XML para comen¬ 
tarios regulares de varias líneas. 

• Use la opción /doc del compilador de C# para especificar el nombre del 
archivo que debería contener la documentación XML generada. 

El listado 2.4 muestra la aplicación Helio World 1 con comentarios de docu¬ 
mentación XML. 

Listado 2.4. La aplicación Helio World! con comentarios XML 

/// La clase HelloWorld es la única clase de la 
/// clase "HelloWorld". La clase implementa la función 
/// Main() de la aplicación. La clase no contiene otras 
/// funciones. 

class HelloWorld 
{ 

/// Ésta es la función Main() para la clase del listado 2.4. 

/// No devuelve un valor y no toma ningún 

/// argumento. Escribe el texto "Helio World!" en la 

/// consola y luego sale. 


65 



static void Main () 


{ 

System.Consolé.WriteLine("Helio World!"); 

} 


Puede compilar esta aplicación con la opción /doc para generar documenta¬ 
ción XML para el código fuente: 

esc /doc:He11oWorId.xml HelloWorld.es 

El compilador produce un HelloWorld.exe como era de esperar y tam¬ 
bién un archivo llamado HelloWorld.xml Este archivo contiene un documento 
XML con sus comentarios de documentación XML incrustados en el. El listado 
2.5 muestra el documento XML que se genera cuando se compila con la opcion / 
doc el codigo del listado 2.4. 

Listado 2.5. Documento XML generado para el código del listado 2.4 

<?xml versión-"1.0"?> 

<doc> 

< a s s e mb 1 y > 

<ñame>He11oWorld</name> 

< / a s s e mb 1 y > 

<membe rs > 

cmember name="T:HelloWorld"> 

La clase HelloWorld es la única clase de la 
clase "HelloWorld". La clase implementa la función 
MainO de la aplicación. La clase no contiene otras 
funciones. 

</member> 

cmember name="M:HelloWorld.Main"> 

Esta es la función Main() para la clase del listado 2.4. 

No devuelve un valor y no toma ningún 
argumento. Escribe el texto " HelloWorld!" en la 
consola y luego sale. 

< / me mb e r > 

</membe rs > 

< / d o c > 

Ahora puede escribir una hoja de estilo para este documento en XML y mos¬ 
trarlo en una página Web. proporcionando a los demás usuarios documentación 
actualizada de su código. 

La principal porción del documento XML está en el elemento <members>. 
Este elemento contiene una etiqueta <member> para cada objeto documentado 
en el codigo fuente. La etiqueta cmember> contiene un atributo, ñame, que 
designa al miembro documentado. El valor del atributo ñame empieza con un 
prefijo de una letra que describe el tipo de información en cuestión. La tabla 2.1 
describe los posibles valores del atributo del nombre y su significado. 
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Tabla 2.1. Prefijos de atributo <member> "ñame- 1 


Prefijo 

Significado 

E 

El elemento proporciona documentación de un evento. 

F 

El elemento proporciona documentación de un campo. 

M 

El elemento proporciona documentación de un método. 

N 

El elemento proporciona documentación de un nombre de 
espacio. 

p 

El elemento proporciona documentación de una propiedad. 

T 

El elemento proporciona documentación de un tipo defini¬ 
do por el usuario. Éste puede ser una clase, una interfaz, 
una estructura, una enumeración o un delegado. 

i 

El compilador C# encontró un error y no pudo determinar el 
prefijo correcto de este miembro. 


Tras el prefijo se colocan dos puntos y el nombre del miembro. El atributo 
ñame- indica el nombre de la clase para los miembros de tipo. Para los miem¬ 
bros de método, el atributo ñame- indica el nombre de la clase que contiene el 
método, seguida por un punto y a continuación el nombre del método. 

Sus comentarios de documentación XML pueden incluir cualquier elemento 
XML válido para ayudarle en su tarea de documentación. La documentación de 
NET Framework recomienda un conjunto de elementos XML que puede usar en 
su documentación. 

El resto de esta sección examina cada uno de estos elementos. Recuerde que 
debe emplear XML válido en sus comentarios, lo que significa que cada elemento 
debe contener su elemento final correspondiente en alguna parte de sus comenta¬ 
rios. 


NOTA: El término etiqueta se refiere a cualquier elemento descriptivo con 
tenido en el XML. Las etiquetas siempre están entre los símbolos < y >. 


<c> 

Puede usar la etiqueta <c> para indicar que una pequeña parte del comentario 
debe ser tratada como código. Las hojas de estilo pueden usar este elemento para 
mostrar la porción de código del comentario con una fuente de tamaño fijo, como 
Courier: 

/// Ésta es la función <c>Main () </c> para la 
/// clase HelloWorld. 
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<code> 

Puede usar la etiqueta <code> para indicar que varias líneas de texto de sus 
comentarios deben ser tratadas como código: 

/// Llamar a esta aplicación con tres argumentos 

/// hara que la matriz de cadenas suministrada a Main() 

/// contenga tres elementos: 

/// <code> 

/// Argument[0]: command line argument 1 
/// Argument[1]: command line argument 2 
/// Argument[2]: command line argument 3 
/// </code > 

<example> 

Puede usar la etiqueta <example> para indicar un ejemplo de cómo usar las 
clases que desarrolle a otros programadores. Los ejemplos suelen incluir una 
muestra de código y quizás quiera usar las etiquetas <example> y <code> 
juntas: 

/// < e x amp 1e >Aqui tiene un ejemplo de un cliente llamando 
/// a este código: 

/// ccode> 

/// ponga aquí su codigo de ejemplo 
/// </code > 

/// </e x amp1e > 

<exception> 

Puede usar la etiqueta <exception> para documentar cualquier excepción 
que pueda surgir en el código del miembro. La etiqueta <exception> debe 
contener un atributo llamado cref cuyo valor especifica el tipo de excepción que 
se documenta. El valor del atributo cref debe estar entre comillas. El texto del 
elemento describe las condiciones en las que aparece la excepción: 

/// cexception cref = "System.Exception" > 

/// Aparece si el valor introducido es menor de 0. 

/// </excepti on> 

El compilador de C# asegura que el valor del atributo cref sea un tipo de 
datos válido. Si no lo es. el compilador genera un mensaje de aviso. A continua¬ 
ción se indica como documentar una función Main ( ) : 

/// <exception c re f *="j unk " >probando</except ion> 

hace que el compilador de C# genere un mensaje de aviso como el siguiente: 

aviso CS1574: El comentario en XML 'Main () ' tiene un atributo cref 
'junk' que no se encuentra 

En este caso, el compilador de C# todavía escribe la etiqueta <e\ccption> en 
el archivo XML. pero pone un signo de exclamación antes del atributo cref: 
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<member name = "M:MyClass .Main"> 

<exception cref = " ! :j unk">probando</exception> 
</membe r> 


<list> 

Puede usar la etiqueta <list> para describir una lista de elementos en la 
documentación. Puede describir una lista no numerada, una lista numerada o una 
tabla. La etiqueta <list> usa un atributo llamado type para describir el tipo 
de la lista. La tabla 2.2 enumera los posibles valores para el atributo type y 
describe su significado. 


Tabla 2.2. Valores para el atributo "type" de la etiqueta <list> 


Valor 

Significado 

bullet 

La lista es una lista no numerada. 

number 

La lista es una lista numerada. 

table 

La lista es una tabla. 


Los estilos bullet y number deberían también incluir una o más etiquetas 
<item> dentro de la etiqueta <list>. 

Cada etiqueta <i tem> se corresponde a un elemento de la lista. Cada etiqueta 
<item> debería contener una etiqueta <description>. cuyo texto define el 
texto de la lista de elementos: 

/// Clist type="bullet " > 

/// <item> 

/// <description>Éste es el elemento 1.</description> 

/// </item> 

/// <item> 

/// <description>Éste es el elemento 2.</description> 

/// </item> 

/// </1is t > 

El tipo de lista table también debe incluir una etiqueta <listheader>. 
La etiqueta <listheader> contiene una o más etiquetas <term> que descri¬ 
ben los encabezamientos de las tablas: 

/// <list type="table"> 

/// <listheader> 

/// <term>Elemento de la tabla </term> 

/// </listheader> 

/// <item> 

/// <description> Éste es el elemento 1.</description> 

/// </item> 

/// </1is t > 


69 



<param> 

Use la etiqueta <param> para documentar un parámetro para una función. 
La etiqueta <param> usa un atributo, ñame, cuno valor identifica al parámetro 
que se está documentando. El texto de la etiqueta <param> proporciona una 
descripción del parámetro: 

/// <param ñame-"F1ag " > 

/// El valor debe ser 0 para desactivado o 1 para activado. 

/// </par am> 

El compilador de C# asegura que el v alor del atributo ñame realmente especi¬ 
fique el nombre de un parámetro. Si no es así. el compilador emite dos avisos. Por 
ejemplo, un codigo fuente como el siguiente: 

/// <param name="]unk">Esto es junk.</param> 

public static void Main(string [] strArguments) 

{ 

} 


produce avisos como los siguientes: 

aviso CS 1572: El comentario XML en 'Main .( string []) ' tiene una 
etiqueta de parametro para 'junk', pero no hay ningún parametro 
con ese nombre 

aviso CS1573: El parametro 'strArguments' no tiene una etiqueta 
de parametro coincidente en el comentario XML (pero otros 
parametros si) 

El primer aviso dice que se encontró una etiqueta <param> con un atributo 
ñame cuno valor no concuerda con ninguno de los parámetros de la función. El 
segundo aviso dice que a uno de los parámetros le falta una etiqueta <param>. 

La etiqueta <param> se coloca en el archivo XML de documentación, inclu¬ 
so si el atributo ñame es incorrecto: 

cmember name="M:Class1.Main(System.String[])"> 

<param name="]unk">Esto es junk.</param> 

</membe r> 

<paramref> 

Puede usar la etiqueta <paramref> para hacer referencia a un parámetro 
desde una descripción. La etiqueta puede no tener ningún texto; sin embargo, 
lleva un atributo llamado ñame. 

El valor del atributo ñame debe indicar el nombre del parámetro al que se 
hace referencia: 

/// La matriz <paramref name="Arguments" /> contiene 

/// los parametros especificados es la linea de comandos. 
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<permission> 

Use la etiqueta <permission> para documentar los permisos disponibles 
en una función o variable dadas. El acceso al código y los datos de una clase 
puede significar el acceso a todo el código o puede ser restringido a cierto 
subconjunto de código. Puede usar la etiqueta <permission> para documen¬ 
tar la disponibilidad del código y sus datos. 

La etiqueta <permission> hace uso de un atributo: cref. El valor del 
elemento cref debe designar la función o la variable cuyos permisos se están 
documentando: 

/// <permission name="Main()"> 

/// Todo el mundo puede acceder a Main(). 

/// </permission> 

<remarks> 

Use la etiqueta <remarks> para añadir información. El elemento <remarks> 
es estupendo para mostrar una vista general de un método o una variable y su uso. 
La etiqueta <remarks> no tiene atributos y su texto contiene las observaciones: 

/// <remarks> 

/// La función Main() es el punto de entrada a la 
/// aplicación. El CLR llamará a Main() para iniciar 
/// la aplicación una vez que ésta se haya abierto. 

/// </remarks> 

<returns> 

Use la etiqueta <returns> para describir un valor devuelto por una fun¬ 
ción. La etiqueta <returns> no tiene atributos y su texto contiene la informa¬ 
ción del valor devuelto: 

/// <returns> 

/// La función Main() devolverá 0 si la aplicación 
/// procesó los datos correctamente y devolverá 1 
/// en caso contrario. 

/// </returns> 

<see> 

Use la etiqueta <see> para añadir una referencia a una función o variable que 
se encuentre en otra parte del archivo. El elemento <see> usa un atributo llama¬ 
do cref cuyo valor especifica el nombre del método o variable al que se hace 
referencia La etiqueta <see> no debe contener texto: 

/// <see cref="Class1.Main" /> 

El compilador de C# asegura que el valor del atributo cref realmente especi¬ 
fique el nombre de un método o variable. Si no es así. el compilador emite un 
aviso. Por tanto, un código fuente como el siguiente: 
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/ // <see c r e f = "j unk" /> 


public static void Main(strmg [] strArguments) 
{ 

} 


produce un aviso como el siguiente: 

aviso CS1574: El comentario XML en 'Class1.Main(string[])' tiene 
un atributo cref 'junk' que no se encuentra 

La etiqueta <see> está situada en el archivo XML de documentación, inclu¬ 
so si el atributo cref es incorrecto: 

<member name^"M:Class1.Main{System. String[] ) "> 

< s e e c r e f = "! :junk"/> 

</membe r > 

<seealso> 

Como <see>. puede usar la etiqueta <seealso> para añadir una referencia 
a una función o variable que esté en otra parte del archivo Puede que necesite 
generar documentación que contenga una sección de referencias <see> además 
de una sección de referencias See Also y el compilador de C# le permite hacer 
esa distinción al admitir las etiquetas <see> y <seealso>. La etiqueta 
<seeaiso> usa un atributo llamado cref cu\o valor especifica el nombre del 
método o variable al que se hace referencia. La etiqueta <seealso> no debe 
contener texto: 

/// <seealso cref="Class1.Main" /> 

El compilador de C# asegura que el valor del atributo cref realmente especi¬ 
fique el nombre de un método o variable. Si no es así. el compilador emite un 
av iso. Por tanto, un código fuente como el siguiente: 

/// cseealso cref="junk" /> 

public static void Main(string [] strArguments) 

{ 

1 

produce un aviso como el siguiente: 

aviso CS1S74: El comentario XML en ' C las s 1 . Ma in ( s t r ing [ ] ) ' tiene 
un atributo cref 'junk' que no se encuentra 

La etiqueta <seealso> esta situada en el archivo XML de documentación, 
incluso si el atributo cref es incorrecto: 

• member name="M:Class1.Main{System.String[] ) "> 

<'seealso £r ef = " ! : j unk " /> 

</membe r > 
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<summary> 

Use la etiqueta <summary> para proporcionar una descripción resumida de 
un fragmento de código. Esta etiqueta no admite ningún atributo. Su texto debe 
describir la información resumida: 

/// <summary> 

/// La función Main() es el punto de entrada de 
/// esta aplicación. 

/// </summary> 

La etiqueta <summary> es como la etiqueta < remarks>. Generalmente, 
debe usar la etiqueta <summary> para proporcionar información sobre un mé¬ 
todo o variable y la etiqueta <remarks> para proporcionar información sobre 
el tipo del elemento. 

<value> 

Use la etiqueta <value> para describir una propiedad de la clase. La etique¬ 
ta <value> no tiene atributos. Su texto debe documentar la propiedad: 

/// <value> 

/// La propiedad MyValue devuelve el número de registros 
/// leidos de la base de datos. 

/// </value> 

public int MyValue 
{ 

// ... el código de propiedad viene aqui ... 

} 

Resumen 

Este capítulo muestra cómo crear aplicaciones C# con un simple editor de 
texto, como el Bloc de notas. También examina varias alternativas a Visual Studio 
para escribir código. 

Ha construido su primera aplicación de C#. Las aplicaciones C#. indepen¬ 
dientemente de su tamaño, deben contener una clase con una función llamada 
Main () . La función Main () es el punto de partida de su aplicación de C#. 

También aprendió a añadir comentarios al código fuente en €#. Puede añadir 
comentarios al código para ayudar a otros programadores a comprender cómo 
está estructurado el código fuente. También puede dar formato a las comentarios 
de tal modo que el compilador pueda convertir los comentarios en un documento 
XML: y añadiendo palabras clave especiales, puede hacer el documento XML 
muy rico e informativo. 
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Bel Trabajar 
con variables 


El codigo de C# suele trabajar con valores que no se conocen cuando se escribe 
el código. Puede que necesite trabajar con un valor leído de una base de datos en 
tiempo de ejecución o quizás necesite almacenar el resultado de un cálculo. Cuan¬ 
do necesite almacenar un valor en el tiempo de ejecución, use una variable. Las 
variables son los sustitutos de los valores con los que trabaja en su código. 

Cómo dar nombre a sus variables 

Cada variable que use en su código C# debe tener un nombre. El compilador de 
C# interpreta los nombres de las variables como identificadores y. por tanto, 
deben seguir las convenciones de designación de los identificadores: 

• El primer carácter de un identificador debe empezar con una letra mayús¬ 
cula o minúscula o con un carácter subrayado. 

• Los caracteres que siguen al primero pueden ser cualquiera de los siguientes. 
• Una letra mavúscula o minúscula 


• Un número 

• Un subravado 



NOTA: C# admite código fuente escrito con caracteres Unicode. Si está 
escribiendo su código fuente usando un conjunto de caracteres Unicode, 
puede usar cualquier carácter de entre las clases de caracteres Unicode Lu, 
Ll, Lt, Lm, Lo, NI, Mn, Me, Nd, Pe y Cf en su identificador. Consulte la 
sección 4.5 de las especificaciones de Unicode si desea obtener más infor¬ 
mación sobre las clases de caracteres Unicode. 


También puede usar una palabra clave de C# como nombre de variable, pero 
sólo si va precedida del carácter a No obstante, no se trata de una práctica 
recomendable, ya que puede hacer que su código resulte difícil de leer, pero es 
factible y el compilador de C# lo permite. 

Asignación de un tipo a una variable 


A las variables de C# se les asigna un tipo, que es una descripción del tipo de 
datos que va a contener la variable. Quizás quiera trabajar con números enteros, 
números de coma flotante, caracteres, cadenas o incluso un tipo que puede definir 
en su codigo. Cuando define una variable en su código CU. debe asignar un tipo a 
la variable. La tabla 3 1 describe algunos de los tipos básicos de variables de CU. 

Tabla 3.1. Tipos de datos comunes de C# 


Tipo Descripción 


sbyte Las variables con tipo sbyte pueden contener números 

enteros de 8 bits con signo. La ‘s’ de sbyte significa 
‘con signo’, lo que quiere decir que el valor de la variable 
puede ser positivo o negativo. El menor valor posible 
para una variable sbyte es -128 y el mayor es 127. 

byte Las variables con tipo byte pueden contener números 

enteros de 8 bits sin signo. A diferencia de las variables 
sbyte, las variables byte no tienen signo y sólo pue¬ 
den contener números positivos. El valor más pequeño 
posible para una variable byte es 0; el valor más alto es 
255. 

short. Las variables con tipo short puede contener números 

enteros de 16 bits con signo. El menor valor posible para 
una variable short es -32.768; el valor más alto es 
32.767. 

ushort Las variables con tipo ushort pueden contener núme¬ 

ros enteros de 16 bits sin signo. La ‘u’ de ushort signifi- 
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Tipo 


Descripción 


int 


uint 


long 


ulong 


cha r 


f loa t 


double 


decimal 


bool 


ca sin signo. El menor valor posible para una variable 
ushort es 0; el valor más alto es 65.535. 

Las variables con tipo int pueden contener números en¬ 
teros de 32 bits con signo. El menor valor posible para una 
variable int es -2.147.483.648; el valor más alto es 
2.147.483.647. 

Las variables con tipo uint pueden contener números 
enteros de 32 bits sin signo. La ‘u’ en uint significa sin 
signo. El menor valor posible para una variable uint 
variable es 0; el valor más alto posible es 4.294.967.295. 

Las variables con tipo long pueden contener números 
enteros de 64 bits con signo. El menor valor posible para 
una variable long es 9.223.372.036.854.775.808; el va¬ 
lor más alto es 9.223.372.036.854.775.807. 

Las variables con tipo ulong pueden contener números 
enteros de 64 bits sin signo. La l u’ en ulong significa sin 
signo. El menor valor posible para una variable ulong 
es 0; el valor más alto es 18.446.744.073.709.551.615. 

Las variables con tipo char pueden contener caracteres 
Unicode de 16 bits. El menor valor posible para una va¬ 
riable char es el carácter Unicode cuyo valor es 0; el 
valor más alto posible es el carácter Unicode cuyo valor 
es 65.535. 

Las variables con tipo float pueden contener un valor 
de coma flotante de 32 bits con signo. El menor valor 
posible para una variable float es aproximadamente 
1,5 por 10 elevado a 45; el valor más alto es aproxima¬ 
damente 3,4 por 10 elevado a 38. 

Las variables con tipo double pueden contener un valor 
de coma flotante de 64 bits con signo. El menor valor 
posible para una variable double es aproximadamente 
5 por 10 elevado a 324; el valor más alto es aproximada¬ 
mente 1,7 por 10 elevado a 308. 

Las variables con tipo decimal pueden contener un va¬ 
lor de coma flotante de 128 bits con signo. Las variables 
de tipo decimal son buenas para cálculos financieros. 
El menor valor posible para una variable decimal es 
aproximadamente 1 por 10 elevado a 28; el valor más 
alto es aproximadamente 7,9 por 10 elevado a 28. 

Las variables con tipo bool pueden tener uno de los dos 
posibles valores: true o false. El uso del tipo bool es 
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Tipo 


Descripción 


una de las partes en las que C# se aparta de su legado C 
y C++. En ellos, el valor entero 0 era sinónimo de false 
y cualquier valorque no fuese cero era sinónimo detrue. 
Sin embargo, en C# los tipos no son sinónimos. No pue¬ 
de convertir una variable entera en su valor equivalente 
bool . Si quiere trabajar con una variable que necesita 
tener una condición verdadera o falsa, use una variable 
bool y no una variable int. 


Cómo aplicar tamaño a sus variables 

Se estará preguntando por qué C# admite todos estos tipos de variables 
diferentes. Los valores más pequeños pueden colocarse en variables de 
mayores tipos; por lo tanto ¿por qué usar los tipos más pequeños? Si una 
variable short puede contener valores desde -32.768 hasta 32.767, y una 
grande puede contener valores desde -9.223.372.036.854.775.808 hasta 
9.223.372.036.854.775.807, entonces es evidente que todos los posibles 
valores short pueden ser almacenados en una variable long. Entonces, 
¿para qué sirven los tipos short? ¿Por qué no usar un variable long 
para todo? 

Una respuesta es el consumo de memoria. Una variable long puede conte¬ 
ner valores más grandes, pero también necesita más memoria. Una variable 
short usa 16 bits (dos bytes), mientras que una grande usa 32 bits (cuatro 
bytes de memoria). Si va a trabajar con valores que no van más allá del 
límite de una variable short, use la variable short. Es una buena cos¬ 
tumbre usar toda la memoria que necesite, pero no usar más de la necesaria. 


Cómo declarar sus variables 


Antes de poder usar su variable, debe declararla en su código. Al declarar una 
variable informa al compilador de C# del tipo y nombre de su variable. Una 
variable se declara escribiendo su tipo, seguido de algún espacio en blanco v. a 
continuación, del nombre de la variable. Termine la declaración con un punto v 
coma. 

Algunos ejemplos de declaración de v ariables son: 

byte MyByteVariable; 

int_Va.Lúe 1 2 3 ; 

ulong AVeryLargeNumber; 
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NOTA: Los espacios en blanco se definen como cualquier número de 
espacios necesario para mejorar la legibilidad del código. 


Debe declarar sus variables dentro de una clase o de una función. El siguiente 
código es válido: 

class MyClass 
{ 

mt MylntegerVariable; 

static void Main() 

{ 

float AnotherVariable; 

System.Consolé.WriteLine("Helio!"); 



NOTA: Puede declarar una variable donde desee, pero tenga en cuenta 
que si la declara en una función, como se muestra en la variable 
AnotherVariable del ejemplo anterior, sólo el código incluido en esa 
función podrá trabajar con la variable. Si la declara dentro de la clase, 
como en la variable MylntegerVariable (también en el ejemplo ante¬ 
rior), todo el código de esa clase podrá trabajar con esa variable. Si toma el 
código del ejemplo y le añade otra función a la clase, el código de esa nueva 
función podrá trabajar con la variable MylntegerVariable pero no 
podrá trabajar con la variable AnotherVariable. Si esta nueva fun¬ 
ción intenta acceder a la variable AnotherVariable declarada en la 
función Main (), obtendrá el siguiente mensaje de error del Compilador de 
C#: 

error CS0103: El nombre 'AnotherVariable' no existe en la clase 
o espacio de nombre 'MyClass' 


Uso de valores por defecto en las variables 

En otros lenguajes de programación, es posible trabajar con una variable sin 
antes asignarle un valor. Este vacío es una fuente de errores, como demuestra el 
siguiente código: 

class MyClass 

{ 

static void Main() 
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int MyVariable; 


// ¿Cuál es el valor de "MyVariable" 


aquí ? 


¿Cuál es el valor de MyVariable cuando se ejecuta Main { ) i} Su valor es 
desconocido porque el código no asigna ningún valor a la variable. 

Los programadores de C# eran conscientes de los errores que podían aparecer 
como resultado de usar variables a las que no se las ha asignado explícitamente 
un valor 

El compilador de C# busca condiciones como ésta y genera un mensaje de 
error. Si la función Main ( ) del codigo anterior hace referencia a la variable 
MyVariable sin que se le haya asignado un valor, el compilador de C# muestra 
el siguiente mensaje de error: 

error CS0165: Uso de la variable local no asignada 'MyVariable' 

C# distingue entre variables asignadas y no asignadas. Las variables asigna¬ 
das han recibido un valor en algún punto del código y las variables no asignadas 
no han recibido ningún valor en el código. En C# no se permite trabajar con 
variables no asignadas porque sus valores son desconocidos y emplear estas va¬ 
riables puede generar errores en su código. 

En algunos casos. C# otorga valores por defecto a variables. Uno de estos 
casos es una variable declarada en el nivel de clase. Las variables de clase reciben 
valores por defecto si no se les asigna un valor en el código. Modifique el código 
anterior cambiando la variable MyVariable de una variable declarada en el 
nivel de función a una variable declarada en el nivel de clase: 

class MyClass 

{ 

static int MyVariable; 

static void Main() 

{ 

// MyVariable recibe un valor por 
// defecto y puede ser usada aqui 

} 

} 


Esta acción mueve la declaración de la variable dentro de la variable de clase 
y la variable ahora es accesible para todo el código incluido en la clase, no sólo en 
la función Main () . C# asigna valores por defecto a variables de nivel de clase 
y el compilador de C# le permite trabajar con la variable MyVariable sin asig¬ 
narle un valor inicial. 

La tabla 3.2. enumera los valores que se asignan por defecto a las variables 
de clase. 
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Tabla 3.2. Valores por defecto de las variables 


Tipo de variable 

Valor por defecto 

sbyte 

0 

by te 

0 

short 

0 

ushor t 

0 

int 

0 

uint 

0 

long 

0 

ulong 

0 

char 

carácter Unicode con valor 0 

f loa t 

0.0 

double 

0.0 

decimal 

0.0 

bool 

false 


Asignación de valores a variables 

En algún punto de su código, querrá darle a sus variables un valor. Asignar un 
valor a una variable es sencillo: se escribe el nombre de la variable, el símbolo 
igual, el valor y se termina la instrucción con un punto y coma: 

MyVariable = 123; 

Puede asignar un valor a la variable cuando declara la variable: 

int MyVariable = 123; 

Aprenderá otros medios de asignar valores a las variables en las secciones 
posteriores. 

Uso de matrices de variables 

Las matrices simplemente son bytcs de memoria contiguos que almacenan 
datos a los que se accede usando un índice que está en la matriz. En esta sección 
se analizan las matrices unidimensionales, multidimensionales y escalonadas. 
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Declaración de matrices unidimensionales 

Suponga que está escribiendo una aplicación de C# para que los profesores 
introduzcan las calificaciones de los exámenes para cada uno de los estudiantes 
de su clase y quiere declarar variables que almacenen la puntuación del examen 
de cada alumno. 

Como la calificación del examen esta entre 0 y 100 puede usar tipos byte. Si 
su programa admite 25 estudiantes en una clase, su primer pensamiento puede ser 
declarar 25 variables por separado: 

Byte TestScoreForStudent1; 

Byte TestScoreForStudent2; 

Byte TestScoreForStudent3; 

// ... mas . . . 

byte T e s t S c o r e F o r S t u d e n 12 5; 

Esto requerirá mucho tiempo y su codigo sera difícil de leer y mantener con 
todas esas variables. Lo que necesita es un modo de decir. "Quiero tener una 
colección de 25 variables". Es decir, lo que queremos es una matriz. 

Una matriz es una colección de variables, cada una de las cuales tiene el 
mismo tipo de variable. Las matrices tienen un tamaño, que especifica cuantos 
elementos pueden contener 

La declaración de una matriz es algo asi: 

byte [] TestScoresForStudents ; 

La declaración byte especifica que todos los elementos de la matriz son 
valores de tipo byte Mediante los corchetes se indica al compilador de C# que 
quiere crear una variable de matriz, en vez de una sola variable, y el identificado!* 
Tes t Scor es For Students es el nombre de la matriz. 

El elemento que falta en esta declaración es el tamaño de la matriz. ¿Cuántos 
elementos puede contener esta matriz? El tamaño de la matriz se especifica me¬ 
diante el operador de C# new. Este operador indica al compilador de C# que 
quiere reservar suficiente memoria para una nueva variable: en este caso, una 
matriz de 25 variables byte: 

byte f] TestscoresForStudents ; 

TestScoresForStudents = new byte[25]; 

La palabra clave byte indica al compilador que quiere crear una nueva ma¬ 
triz de variables byte. y [25] indica que quiere reservar suficiente espacio 
para 25 variables byte. Cada variable de la matriz se denomina elemento de la 
matriz, y la matriz que acaba de crear contiene 25 elementos. 

Debe acordarse de especificar el tipo de matriz cuando use la palabra clave 
new. aunque ya haya especificado el tipo de la matriz cuando la declaró. Si 
olvida hacerlo, obtendrá un mensaje de error del compilador. El código: 
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byte [] TestScoresForStudents; 

TestScoresForStudents = new [25]; 

hace que el compilador de C# emita el error: 

error CS1031: Se esperaba un tipo 

Este error aparece porque el código no tiene un tipo de variable entre la nueva 
palabra clave y el tamaño de la matriz. 

También debe recordar usar el mismo tipo que usó cuando declaró la matriz. 
Si usa un tipo diferente, obtendrá otro mensaje de error, como demuestra el si¬ 
guiente código: 

byte [] TestScoresForStudents; 

TestScoresForStudents = new long[25]; 

Este código hace que el compilador de C# emita el error: 

error CS0029: No se puede convertir implicitámente el tipo 

' long[]' a 'byte[] ' 

El error se produce porque el tipo de la instrucción (byte) no concuerda con 
el tipo usado en la nueva instrucción (long). 

Las matrices como ésta se llaman matrices unidimensionales Las matrices 
unidimensionales tienen un factor que determina su tamaño. En este caso, el único 
factor que determina el tamaño de la matriz es el numero de estudiantes de la 
clase. 

El valor inicial de los elementos de la matriz queda determinado por los valo¬ 
res por defecto del tipo de matriz. Cada elemento de la matriz se inicializa con un 
valor por defecto de acuerdo con la tabla 3.2. Como esta matriz contiene elemen¬ 
tos de tipo byte. cada elemento de la matriz tiene un valor por defecto de 0. 

Cómo trabajar con los valores de las matrices unidimensionales 

Acaba de crear una matriz con 25 elementos de tipo byte. Cada elemento de 
la matriz tiene un número. El primer elemento de la matriz ocupa el índice cero, y 
el último elemento de la matriz es uno menos que el número de elementos de la 
matriz (en este caso, el último elemento es el elemento 24). Las matrices de C# 
se llaman matrices de base cero porque los números de sus elementos empiezan 
en el cero. 

Trabajar con un elemento individual de la matriz es sencillo. Para obtener un 
valor de la matriz, acceda a él con el nombre de la variable y el número de la 
v ariable entre corchetes, como se muestra en el siguiente código: 

byte FirstTestScore; 

FirstTestScore = TestScoresForStudents [0] ; 


83 



Este código accede al primer elemento de la matriz Tests co¬ 
res ForStudents y asigna su valor a la primera variable FirstTestScore 
variable. 

Para poner un valor en la matriz, simplemente acceda al elemento usando la 
misma sintaxis, pero coloque el nombre de la matriz y el numero del elemento a la 
izquierda del signo igual: 

TestScoresForStudents [ 9] = 100; 

Este codigo almacena el valor 100 en el décimo elemento de la matriz 
TestScoresForStudents. C# no permite acceder a un elemento que no se 
encuentre en la matriz. Como la matriz que ha definido contiene 25 elementos, los 
números de los elementos posibles van de 0 a 24. inclusive. Si usa un numero de 
elemento inferior a 0 o mayor que 24. obtendrá un mensaje de tiempo de ejecu¬ 
ción. como se muestra en el siguiente código: 

TestScoiesForStudents[1000] = 123; 

Este código se compila sin errores, pero al ejecutar la aplicación se produce un 
error porque no hay un elemento 1000 en su matriz de 25 elementos. Cuando se 
llega a esta instrucción, el Entorno de ejecución común (CLR) detiene el progra¬ 
ma e inicia un mensaje de excepción: 

Exception occurred; System.IndexOutOfRangeException: An exception 

of type System. Inciex.OutOfRangeException was thrown. 

Indez.OutOf RangeEzception indica que la aplicación intentó acceder 
a un elemento con un numero de elemento que no tiene sentido para la matriz. 

Inicialización de valores de elementos de matriz 

Supongamos que quiere crear una matriz de cinco números enteros y que el 
valor de cada elemento sea distinto del que nos ofrecen por defecto. Puede escribir 
instrucciones individuales para inicializar los valores de la matriz: 

mt f ] MyAr r a y ; 

MyArray - new mt. [5] ; 

MyArray[01 - 0; 

MyArray[ 1 1 - 1; 

MyArray f2 ] = 2 ; 

MyArray[3] - 3; 

MyArray[4] = 4; 

Si al escribir el codigo ya conoce los valores con los que quiere inicializar la 
matriz, puede especificar los valores en una lista separada por comas y encerrada 
entre llaves. Ea lista se coloca en la misma línea que la declaración de matriz 
Puede poner todo el codigo anterior en una sola linea escribiendo lo siguiente: 

i n t [ ] M y A rray = í Q , 1, 2 , 3 , 4 } ; 
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Usando esta sintaxis, no especifica el nuevo operador o el tamaño de la matriz 
El compilador de C# examina su lista de valores y calcula el tamaño de la matriz. 


Declaración de matrices multidimensionales 

Puede pensar en una matriz unidimensional como en una línea. Se extiende en 
una dirección. Puede imaginarse una matriz multidimcnsional con dos dimensio¬ 
nes como un trozo de papel de gráfica. Sus dimensiones no sólo se extienden hacia 
fuera, sino también hacia abajo. Esta sección estudia los tipos más comunes de 
matriz. 

Uso de matrices rectangulares 

Continuamos con el ejemplo de las calificaciones de los exámenes. La matriz 
unidimensional definida en la sección previa contenía un conjunto de calificacio¬ 
nes de 25 estudiantes. Cada estudiante dispone de un elemento en la matriz para 
almacenar una calificación Pero, ¿qué ocurre si quiere almacenar varias califica¬ 
ciones para varios estudiantes? Ahora tiene una matriz con dos factores que afec¬ 
tan a su tamaño: el número de estudiantes y el número de exámenes. Suponga que 
sus 25 estudiantes harán 10 exámenes a lo largo del curso. Eso significa que el 
profesor tiene que corregir 250 exámenes por curso. Puede declarar una matriz 
unidimensional para que contenga las 250 calificaciones: 

byte [] TestScoresForStudents; 

TestScoresForStudents = new byte[250]; 

Pero esto podría resultar confuso. ¿Cómo se usa esta matriz? ¿Aparecen pri¬ 
mero las puntuaciones de un solo estudiante o colocamos en primer lugar las 
calificaciones del primer estudiante 9 

Un modo mejor de declarar una matriz consiste en especificar cada dimensión 
por separado. Declarar una matriz multidimcnsional es tan sencillo como colocar 
comas entre los corchetes. Coloque una coma menos que el numero de dimensio¬ 
nes necesarias para su matriz multidimcnsional. como en la siguiente declaración: 

byte [,] TestScoresForStudents; 

Esta declaración define una matriz multidimcnsional de dos dimensiones. 

Usando el operador new para crear una nueva matriz de este tipo es tan senci¬ 
llo como especificar las dimensiones individualmente, separadas por comas, en 
los corchetes, como se muestra en el siguiente código: 

byte [,] TestScoresForStudents; 

TestScoresForStudents = new byte [10, 25]; 

Este código indica al compilador de C# que quiere crear una matriz con una 
dimensión de 10 y otra dimensión de 25. Puede imaginar una matriz de dos di- 
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mensiones como una hoja de calculo de Microsoft Excel con 10 filas y 25 colum¬ 
nas. La tabla 3.3 recoge el aspecto que podría tener esta matriz si sus datos 
estuvieran en una tabla. 


Tabla 3.3. 

Representación 

en una tabla de 

una matriz de dos dimensiones 

Examen 

Estudiante 1 

Estudiante 2 

Estudiante 3... 

Estudiante 25 

Examen 1 

90 

80 

85 

75 1 

Examen 2 

95 

85 

90 

80 

Examen 10 

100 

100 

100 

100 


Para acceder a los elementos de una matriz de dos dimensiones, use las mismas 
reglas para numerar elementos que en las matrices unidimensionales. (Los núme¬ 
ros de elemento van de 0 a uno menos que la dimensión de la matriz.) También se 
usa la misma sintaxis de coma que uso con el operador new. Escribir codigo para 
almacenar una calificación de 75 para el primer examen del alumno 25 seria algo 
asi: 

Test.Scores For Stuclents [ 0 , 2 4] - 7 5; 

Leer la calificación del quinto examen del alumno 16 sería algo asi: 

byte Fi t thScoreForStudent 1 c; 

f i i thScoreFor S Lucient 1 6 = TestScoresForStudents [4, 15] ; 

En otras palabras, cuando trabaje con una matriz de dos dimensiones v consi¬ 
dere la matriz como una tabla, considere la primera dimensión como el número de 
fila de la tabla y el segundo numero como el numero de columna. 

Puede inicial izar los elementos de una matriz multidimensional cuando declare 
la variable de matriz. Para ello, coloque cada conjunto de valores para una sola 
dimensión en una lista delimitada por comas rodeada por llaves: 

mt [ , ] MyAr r ay - { { ú , 1, 2 } , { 3 , 4 , 5 } } ; 

Esta instrucción declara una matriz de dos dimensiones con dos filas v tres 
columnas. Los valores enteros 0. 1 y 2 están en la primera fila, y los valores 3. 4 
y 5 están en la segunda fila. 

Las matrices de dos dimensiones con esta estructura se llaman matrices rec¬ 
tangulares. Estas matrices tienen la forma de una tabla; cada fila de la tabla tiene 
el mismo numero de columnas. 

C# permite definir matrices con más de dos dimensiones. Para ello basta con 
utilizar mas comas en la declaración de la matriz. 
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Puede definir una matriz de cuatro dimensiones con tipo long. por ejemplo, 
con la siguiente definición: 

long [,,,] ArrayWithFourDimensions; 

Asegúrese de definir todas las dimensiones cuando use el operador new: 

ArrayWithFourDimensions = new long [5, 10, 15, 20]; 

El acceso a los elementos de la matriz se realiza de la misma manera. No 
olvide especificar todos los elementos de la matriz: 

ArrayWithFourDimensions[ 0, 0, 0, 0] = 32768436; 

Definición de matrices escalonadas 

C# permite definir matrices escalonadas, en las que cada tila puede tener un 
número diferente de columnas. Volvamos al ejemplo de las calificaciones de los 
estudiantes para explicarlo. Suponga también que el número máximo de exáme¬ 
nes es 10. pero algunos estudiantes no tienen que hacer los últimos exámenes si 
obtuvieron buena nota en los anteriores. Puede crear una matriz rectangular para 
lo que necesita almacenar, pero puede acabar con elementos que no se utilizan en 
su matriz rectangular. Si algunos estudiantes no hacen todos los exámenes, tendrá 
elementos en su matriz rectangular que no se usan. Estos elementos desaprove¬ 
chados equivalen a memoria desperdiciada, lo que pretendemos evitar. 

Una estrategia mejor consiste en definir una matriz en la que cada elemento de 
la matriz sea. en sí mismo, una matriz. La figura 3.1 ejemplifica este concepto. 
Muestra al estudiante 1 con espacio para tres calificaciones, al estudiante 2 con 
espacio para cinco calificaciones, al estudiante 3 con espacio para dos califica¬ 
ciones v al estudiante 25 con espacio para las diez calificaciones (los otros estu¬ 
diantes no aparecen en la figura). 



Figura 3.1. Las matrices escalonadas permiten definir una matriz que contiene otras 
matrices, cada una con un número diferente de elementos. 


Estas matrices escalonadas tienen dos dimensiones, como las matrices rec¬ 
tangulares. pero cada fila puede tener un número de elementos diferente (lo que 
da a las matrices su aspecto escalonado). 
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Las matrices escalonadas se definen utilizando dos grupos de corchetes inme¬ 
diatamente después del nombre del tipo de matriz. Cuando hace una llamada a 
new. se especifica un tamaño para la primera dimensión (la matriz student en 
nuestro ejemplo), pero no la segunda. Tras definir la primera matriz, haga una 
nueva llamada a new para definir las otras matrices (las matrices score en 
nuestro ejemplo): 

byte [][] ArraysOfTestscores; 

ArraysOfTestScores = new byte [25][]; 

ArraysOfTestScores[0 ] = new byte[3]; 

ArraysOfTestScores[ 1 ] = new byte[5]; 

ArraysOfTestScores[2 ] = new byte[2]; 

ArraysOfTestScores[24 ] = new byte[10]; 

Una vez que ha construido la matriz escalonada, puede acceder a sus elemen¬ 
tos de la misma forma que en una matriz rectangular. 

Tipos de valor y de referencia 


Recuerde que debe usar la palabra clave new para crear la matriz. Este requi¬ 
sito es distinto de los tipos que hemos visto hasta ahora. Cuando trabaje con 
codigo que use variables int o long. por ejemplo, puede usar la variable sin 
usar new: 

int IntegerVariable; 

IntegerVariable = 12345; 

¿Por que son tan diferentes las matrices? ¿Por qué se necesita utilizar new al 
crear una matriz 7 La respuesta está en la diferencia entre tipos de valor v tipos de 
referencia. 

Con un tipo de valor, la variable retiene el valor de la variable. Con un tipo de 
referencia. la variable retiene una referencia al valor almacenado en algún otro 
sitio de la memoria. Puede imaginar una referencia como una variable que apunta 
hacia otra parte de memoria La figura 3.2 muestra la diferencia. 

int IntegerVariable 
123 


long LongVariable 
456 


double [] ArrayOfDoubles 


#--— 


0.0 

0.0 

0.0 

0.0 

0.0 


Figura 3.2. Los tipos de valor contienen datos. Los tipos de referencia contienen 
referencias a datos situados en algún otro lugar de la memoria. 
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Cada uno de los tipos comentados hasta este punto es un tipo de valor. Las 
variables proporcionan suficiente capacidad de almacenamiento para los valores 
que pueden contener y no necesita new para crear un espacio para sus varia¬ 
bles. Las matrices son tipos de valor y los objetos son tipos de referencia. Sus 
valores están en algún otro lugar de la memoria y no necesita usar la palabra 
clave new para crear suficiente espacio para sus datos. 

Aunque necesita usar la palabra clave new para crear espacio de memoria 
para un tipo de referencia, no necesita escribir ningún código que borre la memo¬ 
ria cuando haya acabado de usar la variable. El CLR contiene un mecanismo 
llamado recolector de elementos no utilizados que realiza la tarea de liberar la 
memoria que no se usa. El CLR ejecuta el recolector de elementos no utilizados 
mientras se ejecuta su aplicación de C#. El recolector de elementos no utilizados 
registra su programa buscando memoria no usada por ninguna de sus variables. 
Liberar la memoria que ya no se usa es tarea del recolector de elementos no 
utilizados. 

Cómo convertir tipos de variable 

Puede topar con una situación en la que tenga una variable de un tipo, pero 
necesite trabajar con un fragmento de código que necesite otro tipo. Si. por ejem¬ 
plo. esta trabajando con una variable de tipo int y necesita pasar el valor a una 
función que requiere el uso de una variable de tipo long. entonces necesita 
realizar una conversión de la variable int en variable long. 

C# admite dos tipos de conversiones: conversiones implícitas y conversiones 
explícitas. Las siguientes secciones describen cada uno de estos tipos de conver¬ 
siones. 

Conversiones implícitas 

El compilador de C# realiza automáticamente las conversiones implícitas. 
Examine el siguiente código: 

int IntegerVariable; 

long LongVariable; 

IntegerVariable = 123; 

LongVariable = IntegerVariable; 

En este código, a una variable de tipo entero se le asigna el valor 123 y a una 
variable long se le asigna el valor de la variable de tipo entero. Cuando se 
ejecute este código, el valor de LongVariable es 123. 

El compilador de C# convierte el valor de la variable de tipo entero a un v alor 
long porque la conversión de un valor int a un valor long es una de las 
conversiones implícitas permitidas por C#. La tabla 3.4 recoge las conversiones 
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implícitas permitidas por CU. La primera columna enumera el tipo original de la 
variable y la fila superior enumera los tipos de datos a los que puede convertirlo. 
Una X en la celdilla significa que puede convertir implícitamente el tipo de la 
izquierda al tipo en la parte superior. 

Tabla 3.4. Conversiones implícitas de tipo de valor 


sbyte 

byte 

short 

ushort 

int 

uint 

long 

char 

float 

ulong 

decimal 

double 

X 

- 

X 

- 

X 

- 

X 

- 

X 

- 

X 

- 

: ■ 

X 

X 

X 

X 

X 

X 

- 

X 

X 

X 

- 

• 

- 

X 

- 

X 

- 

X 

- 

X 

- 

X 

X 

- 

- 

- 

X 

X 

X 

X 

- 

X 

X 

X 

X 

: 1 

- 

- 

- 

X 

- 

X 

- 

X 

- 

X 

X 

- 

- 

- 

- 

- 

X 

X 

- 

X 

X 

X 

X 

• 

- 

- 

- 

- 

- 

X 

- 

X 

- 

X 

X 

- 

- 

- 

X 

X 

X 

X 

X 

X 

X 

X 

X 

:■ 

- 

- 

- 

- 

- 

- 

- 

X 

- 

- 

X 

: 

- 

- 

- 

- 

- 

- 

- 

X 

X 

X 

X 


NOTA: No puede convertir ningún tipo a un tipo char (excepto mediante 
la variable char, lo que en realidad no es una conversión). Además, no 
puede hacer conversiones entre los tipos f loating-point y los tipos 
decimales. 


Conversiones explícitas 

Si escribe código que intente convertir un valor que use tipos no admitidos por 
una conversión implícita, el compilador de C# genera un error, como muestra el 
siguiente código: 

char CharacterVari able; 
in t IntegerVariable; 

IntegerVariable = 9; 

CharacterVariable = IntegerVariable; 

El compilador de C# produce el siguiente error: 

error CS0029: No se puede convertir implícitamente el tipo 
' in t' a 'char' 
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Este error se produce porque ninguna conversión implícita admite la conver¬ 
sión de una variable int a una variable char variable. 

Si realmente necesita hacer esta conversión, tiene que realizar una conversión 
explícita. Las conversiones explícitas se escriben en su código fuente y le dicen al 
compilador "haz que se produzca esta conversión, aunque no puede ser realizada 
implícitamente". Escribir una conversión explícita en el código C# requiere colo¬ 
car el tipo al que está convirtiendo entre paréntesis. Los paréntesis se colocan 
justo antes de la variable que está usando como fuente de la conversión. A conti¬ 
nuación se incluve el código anterior pero usando una conversión explícita. 

char CharacterVariable; 

int Int e ge r Van abl en¬ 
lute ge r Vari able = 9; 

CharacterVariable = (char)IntegerVariable; 

Esta técnica es conocida como conversión de la variable de tipo entero a una 
variable de tipo carácter. Algunos tipos no pueden ser convertidos, ni siquiera 
mediante una operación de conversión explícita. La tabla 3.5 enumera las conver¬ 
siones explícitas que admite C#. La primera columna enumera el tipo original de 
la variable v la fila superior enumera los tipos de datos a los que puede convertir¬ 
lo. Una X en la celdilla significa que puede convertir explícitamente el tipo de la 
izquierda al tipo de la parte superior usando la operación de conversión explícita. 


Tabla 3.5. Conversiones explícitas de tipo de valor 


—— sbyte 

byte short ushort int 

uint 

long 

char float uiong decimal double 

X 

X 

- 

X 

X 

- 

X 

X 

- 

- 

- 

i . - X 

X 

- 

- 

- 

- 

- 

X 

- 

- 

- 

X 

X 

X 

X 

- 

X 

X 

X 

- 

- 

- 

X 

X 

X 

X 

- 

- 

- 

X 

- 

- 

- 

X 

X 

X 

X 

X 

X 

- 

X 

- 

X 

- 

: : , ■ X 

X 

X 

X 

X 

X 

- 

X 

- 

- 

- 

¡ : X 

X 

X 

X 

X 

X 

X 

X 

* 

X 

- 

: : X 

X 

X 

- 

- 

- 

- 

X 

- 

- 

- 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

- 

X 

- 

1 . X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X X 

i.- • n . : X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X X 


También puede realizar conversiones explícitas sobre tipos de valor convir¬ 
tiendo explícitamente el valor al tipo apropiado, como se muestra en el siguiente 
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ejemplo. C# permite usar un operador de conversión explícita incluso con con¬ 
versiones implícitas, si lo desea: 

int integerVaríable; 

long ongVariable; 

IntegerVarlable - 123; 

LongVanable - (long) Int egerVar íable ; 

Esta sintaxis no es necesaria, porque C# permite conversiones implícitas de 
variables int a variables long. pero puede escribirlo si quiere. 

Cómo trabajar con cadenas 

C'# admite un tipo de referencia llamado string. El tipo de dato string 
representa una cadena de caracteres Unicode. 


NOTA: Unicode es un estándar mundial de codificación de caracteres. Los 
caracteres Unicode tienen 16 bits, con lo que admiten 65.536 caracteres 
posibles. Los caracteres ANSII tienen 8 bits, y aceptan hasta 256 caracte¬ 
res posibles. 


Use el siguiente código para crear e inicializar una cadena en C#: 

string MyString; 

MyString = "Helio from C#!"; 

AI igual que con el resto de las variables, puede inicializar una cadena en la 
misma linea que su declaración: 

string MyString = "Helio from C#!"; 

Uso de caracteres especiales en cadenas 

C# permite usar una sintaxis especial para insertar caracteres especiales en su 
cadena Estos caracteres especiales aparecen en la tabla 3.6. 

Tabla 3.6. Caracteres especiales de C# 


Caracteres 

Función 

\t 

Los caracteres especiales \t incrustan una tabulación 
en la cadena. Una cadena definida como hello\tthere 
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Caracteres Función 


se almacena en memoria con un carácter de tabulación 
entre las palabras helio y there. 

\ r Los caracteres especiales \r incrustan un retorno de carro 

en la cadena. Una cadena definida como hello\ rthere 
se almacena en memoria con un retorno de carro entre las 
palabras helio y there. El carácter retorno de carro devuel¬ 
ve el cursor al principio de la línea, pero no mueve el cursor 
una línea por debajo. 

\ v Los caracteres especiales \v insertan una tabulación ver¬ 

tical en la cadena. Una cadena definida como hello\ 
vthere se almacena en memoria con un carácter de 
tabulación vertical entre las palabras helio y there . 

\f Los caracteres especiales \f insertan un carácter de im¬ 

presión de página en la cadena. Una cadena definida 
como hello \fthere se almacena en memoria con un 
carácter de impresión de página entre las palabras helio 
y there. Las impresoras suelen interpretar un carácter de 
impresión de página como una señal para pasar a una 
nueva página. 

\ n Los caracteres especiales \n insertan una nueva línea 

en la cadena. Una cadena definida como hello\nthere 
se almacena en memoria con un carácter de nueva línea 
entre las palabras helio y there. La comunidad de 
desarrolladores de software ha debatido durante mucho 
tiempo la interpretación del carácter de nueva línea. Siem¬ 
pre ha significado, "mueve la posición de la siguiente sali¬ 
da una línea más abajo". La duda está en si la operación 
también incluye mover la siguiente posición al primer ca¬ 
rácter de la línea anterior. .NET Framework interpreta el 
carácter de nueva línea como bajarlo una línea y devolver la 
posición del siguiente carácter al principio de la siguiente 
línea. Si no está seguro, siempre puede escribir los carac¬ 
teres especiales \n y \r juntos. 

\x Los caracteres especiales \x permiten especificar un ca¬ 

rácter ASCII usando dos dígitos hexadecimales. Los dos 
dígitos hexadecimales deben seguir inmediatamente a los 
caracteres \x y deben corresponder con el valor 
hexadecimal del carácter ASCII que quiere producir. Por 
ejemplo, el carácter espacio en ASCII tiene el código de 
decimal 32 . El valor decimal 32 es equivalente al valor 
hexadecimal 20. Por tanto, una cadena definida como 
hello\x2 0there se almacena en memoria con un ca¬ 
rácter de espacio entre las palabras helio y there. 
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Caracteres 


Función 


\ u Los caracteres especiales \u permiten especificar un ca¬ 

rácter Unicode usando exactamente cuatro dígitos 
hexadecimales. Los cuatro dígitos hexadecimales deben 
colocarse inmediatamente después de los caracteres \u 
y deben corresponder al valor hexadecimal del carácter 
Unicode que quiere producir. Por ejemplo, el carácter 
espacio en Unicode tiene un código de decimal 32. El valor 
decimal 32 es equivalente al valor hexadecimal 20. Por tanto, 
una cadena definida como hello\u0020therese alma¬ 
cena en memoria con un carácter de espacio entre las pa¬ 
labras helio y there. Asegúrese de usar exactamente cuatro 
dígitos después de los caracteres \u. Si el valor es menor 
de cuatro dígitos, use ceros para rellenar su valor hasta 
que llegue a los cuatro dígitos. 

\\ Los caracteres especiales \\ permiten especificar un ca¬ 

rácter de barra invertida en la posición actual. Una cade¬ 
na definida comohello\\there se almacena en memoria 
con un carácter barra invertida entre las palabras helio y 
there. La razón por la que debe haber dos barras invertidas 
es simple: el uso de una sola barra invertida podría hacer 
que el compiladorde C# la confundiera con el principio de 
otro carácter especial. Por ejemplo, suponga que olvida la 
segunda barra invertida y escribe hello\there en su 
código. El compilador de C# verá la barra invertida y la ‘t’ 
en la palabra there y los confundirá con un carácter de 
tabulación. Esta cadena se almacenaría en memoria con 
un carácter de tabulación entre las palabras helio y there. 
(Recuerde que la T en there se interpretaría como un ca¬ 
rácter de tabulación y no sería parte de la palabra real.) 


Desactivación de los caracteres especiales 
en cadenas 

Puede ordenar al compilador de C# que ignore los caracteres especiales en 
una cadena anteponiendo el signo @ a la cadena: 

string MyStrmg = @"hello\there" ; 

Este código asigna a la variable MyString el valor del texto hello\there. 
Como la cadena tiene delante el signo se desactiva el modo habitual de inter¬ 
pretar los caracteres \t como marcador de tabulación. Esta sintaxis también 
permite escribir nombres de directorio en cadenas de nombre de archivo de C# sin 
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usar la doble barra invertida. Por defecto, siempre necesitará usar las dobles 
barras invertidas: 

string MyFilename = "C: \\Folder 1 \\Folder2 WFolder3\\file.txt ; 

Sin embargo, con el prefijo @, puede conseguirlo con una sola barra invertida: 

string MyFilename = @"C: \Folderl\Folder2\Folder3\f ile.txt"; 

Cómo accederá caracteres individuales 
en la cadena 

Puede acceder a caracteres en la cadena como si la cadena fuese una matriz. 
Conceptualmente, puede imaginarse una cadena como una matriz de caracteres. 
Puede usar la sintaxis de elemento de matriz entre corchetes para acceder a cual¬ 
quier carácter de la cadena: 

char MyCharacter; 

string MyString = "Helio from C#!"; 

MyCharacter = MyString[9]; 

Este código coloca el valor ’m en la variable MyCharacter. El carácter 
m está en el elemento 9 de la cadena, si imagina la cadena como una matriz de 
caracteres. Además, tenga en cuenta que esta matriz de caracteres es de base cero. 
El primer carácter de la cadena se encuentra en realidad en el elemento 0. El 
décimo carácter de esta cadena, como ha aprendido, está localizado en el elemen¬ 
to 9. 

Declaración de enumeraciones 


A diferencia de las v ariables tratadas hasta el momento, una enumeración no 
es un tipo en sí misma, sino una forma especial de tipo de valor Una enumeración 
se deriva de System. Enum y proporciona nombres para valores. El tipo subya¬ 
cente que representa una enumeración debe ser byte. short. int o long. 
Cada campo de una enumeración es estático y representa una constante. 

Para declarar una enumeración, debe usar la palabra clave enum seguida del 
nombre de la enumeración. A continuación debe escribir una llave de apertura 
seguida por una lista de las cadenas de la enumeración y finalizar con una llave 
de cierre, como se muestra en el siguiente ejemplo: 

public enum Pizza 
{ 


Supreme, 
MeatLovers, 
CheeseLovers, 


95 



Vegetable, 


} 

Este código crea una enumeración llamada Pizza. La enumeración pizza 
contiene cuatro pares diferentes nombre/valor que describen diferentes tipos de 
pizza, pero no se definen valores. Cuando declara una enumeración, el primer 
nombre que declara toma el valor 1 y así sucesivamente. Puede invalidar esta 
funcionalidad asignando un valor a cada nombre, como se muestra a continua¬ 
ción: 

public enum Pizza 
{ 

Supr eme = 2 , 

MeatLovers- 3, 

CheeseLovers = 4, 

Vegetable - 5, 

} 


El valor de cada campo de enumeración ha sido incrementado en 1. Aunque no 
todo este codigo es necesario. Asignando a Supreme un valor de 2. los siguien¬ 
tes campos siguen la secuencia. Por tanto, puede eliminar las asignaciones a 
MeatLovers. CheeseLovers.y Vegetable. 

Se puede hacer referencia a los enumeradores de una de estas dos formas. 
Puede programar sobre sus nombres de campo o puede programar sobre sus 
valores. Por ejemplo, puede asignar el nombre de campo a una variable de cade¬ 
na con el siguiente código: 

strinq MyString - Pizza.Supreme; 

Quizas quiera hacer referencia al valor de un campo. Puede conseguirlo me¬ 
diante la conversión de tipos. Por ejemplo, puede recuperar el valor del campo 
Supreme con el siguiente código: 

int. Mylnteger = (int) Pizza . Supreme; 


Resumen 

Este capítulo examina las v ariables y sus tipos. Hay muchas clases de tipos de 
valor y cada uno tiene sus propias características y requisitos de memoria. Algu¬ 
nos tipos pueden ser convertidos implícitamente a otros tipos, pero otros deben 
ser conv ertidos explícitamente usando la sintaxis apropiada. 

Las matrices contienen colecciones de variables del mismo tipo. Son útiles 
cuando se necesita mantener un conjunto de v ariables del mismo tipo. C# admite 
matrices unidimensionales y multidimensionalcs. Las matrices de C# son de base 
cero: es decir, el numero del primer elemento de una matriz es el 0. Las cadenas le 
ayudan a trabajar con partes de texto en su código. Son conjuntos de caracteres 
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Unicode. C# permite incrustar caracteres especiales en sus cadenas, pero pro¬ 
porciona el prefijo @ para especificar los casos en los que no necesite que se 
procesen los caracteres especiales. Se puede acceder a los caracteres de una 
cadena como si fueran matrices de caracteres. 
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4 


Expresiones 


Las expresiones son el elemento básico y fundamental de cualquier lenguaje 
de programación. Mediante el uso de operadores, las expresiones permiten que 
una operación realice comparaciones simples, asignaciones e incluso operacio¬ 
nes muy complejas que necesitarían millones de años para completarse. 

Este capítulo trata del uso de los operadores para realizar funciones matemá¬ 
ticas. asignar valores a variables y realizar comparaciones. Una vez que haya¬ 
mos comprendido estos elementos básicos, estudiaremos algunas expresiones 
avanzadas que usan operadores muy específicos del lenguaje C# y que le brindan 
una ventaja sobre la mayoría de los demás lenguajes de programación. Para ce¬ 
rrar este capítulo, revisaremos las expresiones que usan operadores para mani¬ 
pular la parte más pequeñas de un byte. el bit. 

Cómo usar los operadores 

Las expresiones pueden escribirse usando variables: valores codificados 
específicamente, llamados valores literales (explicados en la sección "Cómo usar 
literales", posteriormente en este mismo capítulo): y símbolos llamados operado¬ 
res. C# admite varios operadores, cada uno de los cuales realiza una acción 
diferente. Las variables o los valores literales que aparecen en una expresión se 
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llaman opéremelos . Los operadores se aplican a los operandos y el resultado de 
la operación es otro valor. 

C# consta tres tipos de operadores: 

• Operadores unarios. trabajan con un solo operando. Una expresión con 
un operando y un operador produce un solo valor. 

• Operadores binarios, trabajan con dos operandos Una expresión con dos 
operandos y un operador produce un solo valor 

• Operadores ternarios, trabajan con tres operandos. C# admite sólo un 
operando ternario. 

Uso de expresiones primarias 

Las expresiones primarias son la base del código C#. C# define varios tipos 
diferentes de expresiones primarias: 

• Literales 

• Identifícadores 

• Expresiones con paréntesis 

• Acceso a miembros 

• Expresiones de invocación 

• Acceso a elementos 

• La palabra clave this 

• Acceso a bases 

• Operadores de incremento y decremento postfijo 

• El operador new 

• El operador typeof 

• Los operadores checked y unchecked 

Las expresiones primarias permiten definir el orden de las operaciones dentro 
de una expresión, definir nuevos literales (por ejemplo, valores codificados 
específicamente) y declarar nuevas variables para la aplicación. En las siguientes 
secciones se examinarán estas expresiones y cómo usarlas. 

Cómo usar los literales 

Los literales son valores codificados específicamente que se pueden escribir 
directamente en el código fuente C#. Hay muchos tipos de literales diferentes. 
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Para mostrar lo que es un literal, examine la siguiente línea de código en C# que 
usa el valor literal Brian. 

if (FirstName == "Brian") 

Aquí se ha codificado el valor de Brian para usarlo en una comparación. En 
lugar de un valor definido por el usuario, es preferible almacenar las cadenas en 
variables de modo que, si hiciera falta cambiar los valores, sólo habria que cam¬ 
biarlos en un sitio sin necesidad de buscar cada una de sus ocurrencias en todas 
las lineas de código. 

El siguiente código muestra el mejor método para almacenar y usar una cade¬ 
na con vistas a compararla: 

string MyFirstName = "Brian; 

if (FirstName == MyFirstName) 

Como puede ver, éste es un enfoque mucho más claro para usar un valor 
literal. 

Literales booleanos 

C# define dos valores literales booleanos. las palabras clave True y False: 

bool MyTrueVariable = true; 

bool MyFalseVariable = false; 

Ambos valores tienen un tipo de valor bool. La palabra clave True es el 
equivalente entero de uno negativo (-1). mientras que el equivalente de False es 
el cero. 

Cómo usar los literales enteros en notaciones decimales y 
hexadecimales 

Se pueden escribir literales enteros usando una notación decimal o una nota¬ 
ción hexadecimal. De forma parecida a los literales vistos anteriormente, estos 
literales permiten ordenar el código. Los valores literales pueden ser colocados en 
la parte superior del listado del código. Si resultara necesario modificar estos en 
alguna ocasión, resultaría muy sencillo cambiar la ocurrencia del valor. 

Los literales decimales integrales se escriben como series de uno o mas núme¬ 
ros usando los caracteres 0, 1. 2. 3. 4. 5, 6. 7, 8 y 9: 

int MyVariable = 125; 

Los literales decimales también pueden contener un sufijo de un carácter que 
especifique el tipo del literal. Si el literal tiene como sufijo una U mayúscula o 
minúscula, el literal decimal se considera de tipo sin signo: 

uint MyVariable = 125U; 
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El termino sin signo significa que no se especifica si el número es positivo o 
negativo. Por tanto, si convierte un valor de 100 negativo (-100) a un valor sin 
signo, su resultado sería simplemente cien (100). 

Si el valor es lo suficientemente pequeño como para poder ser almacenado en 
un tipo uint. el compilador de C# considerará el literal como de tipo uint. Si 
el valor del literal integral es demasiado grande para un tipo uint, el compilador 
de C# considerará el literal como de tipoulong. Los diferentes tipos representan 
el tamaño de la información que está almacenando. El tipo uint puede contener 
un número comprendido entre 0 y 4.294.967.295; mientras que el valor ulong 
puede contener un valor entre 0 y 8.446.744.073.709.55 1.615. 

Si el literal tiene como sufijo una L mayúscula o minúscula, el literal decimal 
se considera de tipo long: 

long MyVariable = 125L; 

Si el valor está dentro del rango de tipo long, el compilador de C# considera¬ 
rá el literal como de tipo long. Si el valor no está dentro del rango de tipo long. 
el compilador de C# considerará el literal como de tipo ulong. 


el jcompilador de C# acepta tanto h l minúscula como la 
L tuayúscuia como sufijos, probablemente prefiera usar la L mayúscula. La 
X minúsculasc parece demasiado al número 1 y si Otros programadores 
leen ú código, podrían confundir la 1 con el 1. 

Si el literal tiene como sufijos L y U. el literal decimal se considera de tipo 
long sin signo: 

ulong MyVariable = 125LU; 

El compilador de C# acepta tanto un sufijo en el que la L aparece delante de 
la U como un sufijo en el que la U aparece delante de la L. Además, el compilador 
de C# acepta la combinación de letras en mayúsculas y en minúsculas. Los sufijos 
LU. Lu. 1U. lu. UL. Ul. uL y ul denominan al sufijo ulong. 

Escribir literales integrales en formato hexadecimal permite escribir un literal 
usando las letras de la A a la F junto a los números del 0 al 9. Los literales 
hexadecimales deben tener el prefijo 0X o Ox: 

int MyVariable - 0x7D; // 7D hex = 125 decimal 

Se pueden usar letras mayúsculas y minúsculas para la notación hexadecimal. 
También se pueden usar como sufijos los mismos caracteres que estaban disponi¬ 
bles para los literales decimales: 

long MyVariable = 0x7DL; 

La decisión de usar un valor hexadecimal queda completamente a discreción 
del programador. Usar hexadecimales en lugar de otro tipo de literales no supone 
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ninguna diferencia respecto a usar cualquier otro tipo de número. No obstante, es 
aconsejable usar valores hexadecimales cuando se está construyendo una aplica¬ 
ción que utilice especificaciones en formato hexadecimal. Por ejemplo, una interfaz 
para el módem de su ordenador. La referencia del programador para su módem 
podría especificar los valores de algunas operaciones en formato hexadecimal. En 
lugar de leer toda la referencia del programador y convertir todos los números al 
sistema decimal, normalmente sólo tendría que codificar estos números 
hexadecimales directamente en la aplicación, evitando así cualquier error de con¬ 
versión. 

Cómo usar los literales reales para valores de coma flotante 

Los literales reales permiten escribir valores de coma flotante en el código C#. 
Los literales reales pueden incluir tanto una coma decimal como un exponente. 

Las comas decimales pueden aparecer en literales reales y los números pue¬ 
den aparecer antes y después de la coma decimal. También es posible que un 
literal real empiece con una coma decimal, lo que es útil cuando se quiere crear 
un valor mayor de cero, pero menor de uno. Los valores como 2,5 y ,75 son 
ejemplos de literales reales. C# no impone ningún limite al número de cifras que 
pueden aparecer antes o después de la coma decimal, mientras el valor del literal 
quede dentro del rango del tipo deseado. También puede especificar un exponen¬ 
te en sus literales reales. Los exponentes se escriben con una E mayúscula o 
minúscula inmediatamente después de la porción decimal del número. Tras la E 
se incluye uno o más números decimales para indicar el valor del exponente. Esto 
quiere decir que se puede escribir el valor 750 como un literal real de 7 . 5e2. 
También puede aparecer un signo más o un signo menos entre la E y el valor del 
exponente. Un signo más significa un exponente con valor positivo; un signo 
menos significa un exponente con valor negativo. El literal real 7.5e + 2 define 
un valor de 750 y el literal real 7.5e-2 define un valor de .075. Si no se usa 
ninguno de los dos signos, el compilador de C# considera que el valor del expo¬ 
nente es positivo. Al igual que los literales decimales, los literales reales también 
pueden llevar detrás un sufijo para especificar el tipo del literal. Si no se usa un 
sufijo en el literal real, el compilador de C# considera que el literal es de tipo 
double. Si el literal real tiene como sufijo una F mayúscula o minúscula, se 
considera que el literal decimal es del tipo f loat: 

float MyVariable = 7.5F; 

Si el literal real tiene como sufijo una D mayúscula o minúscula, se considera 
que el literal decimal es de tipo double: 

double MyVariable = 7.5D; 

Si el literal real tiene como sufijo una M mayúscula o minúscula, se considera 
que el literal decimal es de tipo decimal: 

decimal MyVariable = 7.5M; 
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Cómo usar los literales de carácter para asignar valores 
de carácter 

Los literales de carácter permiten escribir valores de carácter en el código 
CU. Normalmente, los literales de carácter aparecen entre comillas simples: 

char MyVariable = 'a' ; 

También se pueden usar las secuencias de escape vistas en un capítulo ante¬ 
rior para escribir literales de carácter en código C#. Estos literales de carácter 
deben encerrarse entre comillas simples: 

char MyVariable = '\t f ; // carácter tabulador 


NOTA: Si quiere utilizar una comilla simple como literal de carácter, de¬ 
berá anteponerle una barra invertida. Escribir ‘ ” confunde al compilador 
de CU. Escriba en su lugar ‘V\ 


Puede definir valores hexadccimalcs como literales de carácter usando la se¬ 
cuencia de escape \:: seguida de uno. dos o tres caracteres hexadccimales: 

char MyVariable = '\x5C' ; 

Cómo usar los literales de cadena para incrustar cadenas 

Los literales de cadena permiten incrustar cadenas en el código CU. Los litera¬ 
les de cadena se escriben como se indica en un capítulo anterior, poniendo la 
cadena entre dobles comillas: 

string MyVariable - "Helio from C#!"; 

El compilador de CU reutiliza muchos literales de cadena con los mismos con¬ 
tenidos. con lo que conserva espacio en el ejecutable final, como muestra el si¬ 
guiente código: 

string Stringl - "Helio"; 
string Strmg2 = "Helio"; 

Cuando se compila este código, el ejecutable contiene una copia del literal de 
la cadena Helio. Las dos variables de cadena leen el valor de la única copia 
almacenada en el ejecutable. Esta optimización permite al compilador de CU con¬ 
servar el uso de memoria del codigo. ya que almacenar sólo una copia del literal 
requiere menos memoria que almacenar dos copias del mismo literal. 

Cómo usar los literales nuil 

El literal nuil es una palabra clave de CU que permite poner un objeto en un 
estado nulo o sin uso: 

object MyObject = nuil; 
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Uso de identificadores 


Los identificadores C# son ejemplos de expresiones simples. Los identificadores 
tienen un tipo y el tipo se especifica cuando se declara el identificador: 

int MyVariable = 123; 

El identificador MyVariable se considera una expresión y tiene un tipo 
int. Los identificadores pueden ser definidos en cualquier bloque de código que 
se encuentre entre llaves, pero su tipo no puede cambiar: 

public static void Main() 

{ 

int MyVariable = 123; 

MyVariable = 1; // "MyVariable" todavía es un "int” 

MyVariable = 2 ; // "MyVariable" todavía es un "int" 

} 

Si intenta redefinir el tipo de un identificador dentro del mismo bloque de 
código, el compilador de C# generará un mensaje de error: 

public static void Main() 

í 

int MyVariable = 123; 

float MyVariable = 1.25; 

} 

El compilador de C# genera un mensaje de error en la línea que intenta redefimr 

MyVariable como un valor float: 

error CS0128: Ya se ha definido una variable local denominada 
'MyVariable' en este ámbito 

Sin embargo, se puede reutilizar el identificador si aparece en un bloque de 
código separado: 

public static void Main() 

{ 

int MyVariable = 123; 

} 


public void AnotherFunction() 

{ 

float MyVariable - 1.25; 

} 

Expresiones entre paréntesis 

Como su nombre indica, las expresiones entre paréntesis son expresiones en¬ 
cerradas entre paréntesis. El compilador de C# evalúa la expresión incluida en los 
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paréntesis y el valor de la expresión entre paréntesis es el resultado de la evalua¬ 
ción. Por ejemplo, el valor de la expresión entre paréntesis (3+2) es ó. 


Cómo llamar a métodos con expresiones 
de acceso a miembros 

Cuando se necesita llamar a un método de un objeto, se escribe el nombre del 
objeto seguido por un punto y por el nombre del método. Cuando el CLR llama al 
método Main () para empezar a ejecutar la aplicación, crea un objeto a partir de 
su clase y llama a la función Main ( ) de ese objeto. Si se escribiese este código 
en C#, sería algo parecido a lo siguiente: 

MyClass MyObject; 

MyObject - new MyClass () ; 

MyObject.Main(); 

Los objetos se estudian con más detalle en capítulos posteriores. Lo más im¬ 
portante ahora es darse cuenta de que la instrucción que llama a Main ( ) contie¬ 
ne una expresión de acceso a miembros, que contiene un objeto, un punto y una 
llamada de función. 

En capítulos posteriores, verá qué objetos pueden tener datos además de códi¬ 
go. Puede acceder a los datos usando la misma sintaxis de expresión de acceso a 
miembro. 

Cómo llamar a métodos con expresiones 
de invocación 

Las expresiones de invocación se usan para hacer una llamada a un método en 
un objeto. El código usado en el caso del acceso a miembro también muestra una 
expresión de invocación. El código llama a un método (en este caso Main ( ) ). 
que hace que el código invoque al método Main ( ) del objeto. 

Si se llama a un método desde otro método en el mismo objeto, puede usar el 
nombre del método en la llamada. No necesita especificar un objeto o un nombre 
de clase y no es necesaria la sintaxis de acceso a miembro, como muestra el 
listado 4.1 


Listado 4.1. Expresión de invocación 


class MyClass 
{ 

public static void Main() 
{ 


MyClass myclass = new MyClass(); 


106 



myclass.DoWork(); 


} 

void DoWork() 

{ 

// haga aqui su trabajo 


} 

En este ejemplo, el método Main { ) llama a un método DoWork ( ) . Sin 
embargo, antes hace falta crear una referencia a myClass y luego invocar al 
método DoWork ( ) . 

El tipo de una expresión de invocación es el tipo que devuelve la función a la 
que se llama. Si, por ejemplo, el código C# llama a una función que devuelve un 
tipo int. la expresión de invocación que llama a ese método tiene un tipo int. 


Cómo especificar elementos de matriz 
con expresiones de acceso a elementos 

Las expresiones de acceso a elementos permiten especificar elementos de ma¬ 
triz. El número del elemento de matriz se escribe dentro de corchetes: 

int [] MyArray; 

MyArray = new int [5]; 

MyArray[0 ] - 123; 

En este ejemplo, al elemento cero de la matriz llamada MyArray se le asigna 
el valor de 123. 

C# permite que cualquier expresión que produzca un resultado de tipo int, 
uint, long o ulong se utilice como expresión de elemento. C# también permi¬ 
te el uso de cualquier expresión cuyo resultado sea de un tipo que pueda ser 
convertido implícitamente en tipo int, uint, long o ulong. En el código 
anterior, se usa un literal entero como expresión de elemento. Podría igualmente 
escribir un tipo de expresión diferente para especificar el elemento, como muestra 
el listado 4.2. 


Listado 4.2. Acceso a elementos 


class MyClass 
{ 

public static void Main() 

{ 

int [] MyArray; 

MyClass myclass = new MyClass() ; 

MyArray = new int [5]; 

MyArray[myclass.GetArraylndex{)] = 123; 
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} 

int GetArraylndex Ü 
{ 

return ü; 

} 

} 

Este codigo funciona porque el método GetArraylndex ( ) devuelve un 
int y el resultado de la expresión de invocación es un int. Como cualquier 
expresión cu\o valor sea int puede ser usada como expresión de elemento de 
una matriz. C# permite que este código se ejecute. 

El resultado de la expresión de acceso al elemento es el tipo del elemento al que 
se accede, como se muestra en el siguiente código: 

int [] MyArray; 

MyArray = new int [5]; 

MyArray[ÜJ - 12 3; 

La expresión de acceso al elemento MyArray [0] es de tipo int porque el 
elemento al que se accede en la expresión es de tipo int. 

Cómo acceder a objetos con la palabra clave 
this 

C# define una palabra clave this que puede usarse para especificar un obicto 
para un fragmento de código que necesite acceder a ese objeto. La palabra clave 
this se estudia con mas detalle en la sección que trata de las clases. El listado 
4.3 usa la palabra clave this. 

Listado 4.3. Acceso mediante palabra clave 


class MyClass 
í 

public stdtic void Main() 

{ 

// llame DoWork() en este objeto 
MyClass myclass = new MyClass{); 
myclass.DoWork(); 

} 


void DoWork() 

{ 

MyClass myclass = new MyClass ( ) ; 
this.DoWo r k 2 () ; 

// haga aquí su trabajo 
} 
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void DoWork2() 

{ 

} 

} 

En este ejemplo, la expresión de acceso this tiene el tipo MyClass porque 
la clase MyClass contiene el código que incluye la expresión de acceso this. 

Cómo acceder a objetos con la palabra clave 
base 


C# también define la palabra clave base para su uso con objetos. En un 
capítulo posterior aprenderá que puede usar clases como punto de partida para 
construir nuevas clases. Las clases originales reciben el nombre ác clases base \ 
las clases construidas a partir de ellas se llaman clases derivadas. 

Para ordenar al código C# de la clase derivada que acceda a los datos de la 
clase base, se usa la palabra clave base. El tipo para las expresiones que usan 
base es la clase base de la clase que contiene la palabra clave base. 

Cómo usar los operadores postfijo 
de incremento y de decremento 

C# permite incrementar o reducir valores numéricos usando símbolos especia¬ 
les. El operador ++ incrementa el valor y el operador - reduce el valor Se pueden 
aplicar estos operadores a expresiones de tipo sbyte. byte. short. ushort. 
int, uint, long y ulong. El listado 4.4 muestra los operadores de incremen¬ 
to y decrcmento en acción. 

Listado 4.4. Operadores de incremento y de decremento 

class MyClass 

{ 

public static void Main() 

{ 

int Mylnteger; 

Mylnteger = 125; 

Mylnteger++; // el valor ahora es 126 

Mylnteger--; // el valor ahora vuelve a ser 125 

} 

} 

El tipo de una expresión que usa operadores postfijos de incremento \ de 
decrcmento concuerda con el tipo cuyo valor se está incrementando o reduciendo. 
En el listado 4.4. los operadores de incremento y de decrcmento tienen tipo int. 
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Creación de nuevos tipos de referencia 
con el operador new 

El operador new se usa para crear nuevas instancias de tipos de referencia. 
Hasta ahora, el operador new ha sido usado para crear nuevas matrices v cuando 
estudie los objetos, aprenderá a usar el operador new para crear nuevos objetos. 

El operador new es considerado una expresión y el tipo de la expresión con¬ 
cuerda con el tipo de la variable creada con la palabra clave new. 

Cómo devolver información sobre el tipo 
con el operador typeof 

El operador typeof es una palabra clave C# que devuelve información sobre 
el tipo de una variable. Se usa como si fuera una función, empleando la palabra 
clave typeof seguida de una expresión: 

class MyClass 
{ 

public static void Main() 

{ 

System.Consolé.WriteLine(typeof(int)); 



La palabra clave typeof devuelve un objeto llamado System. Type que 
describe el tipo de la variable. El tipo de la expresión typeof es la clase 

System.Type. 

Cómo usar operadores checked y unchecked 

Los operadores checked y unchecked permiten activar o desactivar la verifica¬ 
ción en tiempo de ejecución de las operaciones matemáticas. Si se incluve una 
operación matemática en un operador checked. se informará de un error si la 
operación no tiene sentido. Si se incline una operación matemática en un opera¬ 
dor unchecked. se informará de un error incluso si la operación no tiene sentido 
El listado 4.5 muestra un problema de desbordamiento matemático. Se decla¬ 
ran dos variables enteras. Intl y Int2 y una tercera. IntlPlusInt2. cuyo 
valor almacena la suma de las otras dos. Los dos enteros se suman y el resultado 
se almacena en la tercera variable entera. Entonces el valor de la tercera variable 
se escribe en la consola 

Listado 4.5. Desborde en operaciones matemáticas 

class Listing4_5 
{ 
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public static void Main() 

{ 

int Intl; 
int Int 2; 
int IntlPlusInt2; 

Intl = 2000000000; 

Int2 = 2000000000; 

IntlPlusInt2 - Intl + Int2; 

System.Consolé.WriteLine(IntlPlusInt2); 


A cada variable entera Intl y Int2 se le asigna el valor de dos mil millones. 
Esta operación no supone ningún problema porque las variables enteras pueden 
almacenar valores por encima de dos mil cien millones. Sin embargo, sumar estos 
dos integrales y almacenar el resultado en otro integral va a suponer un problema. 
La suma sería cuatro mil millones, lo que supera el valor limite de un entero, poco 
más de dos mil cien millones. 

Compile el código anterior con la línea de comando habitual: 

esc Listing4-l.cs 

Cuando ejecute el archivo Listing4-1 .exe. obtendrá un gran número negativo, 
como se ve en la figura 4.1. 


c* C:\WINDOWS\System32\cmd.eHe 

C:\>List. int/4-5 .exe 
-294967296 

C:\> 



Ld 


Figura 4.1. Los desbordamientos producen resultados impredecibles. 


Se obtiene un resultado negativo debido al modo que tiene C# de procesar los 
valores demasiado grandes para encajar en las variables destinadas a ellos. C# no 
puedo representar todo el valor de un entero, así que toma el valor propuesto, 
cuatro mil millones y le resta el valor máximo de un valor de 32 bits 
(4.294.967.296). extrayendo el resultado a la consola. 
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Obviamente, el código ha generado un resultado distinto del que queríamos. Si 
no se da cuenta de este tipo de errores matemáticos, su código puede comportarse 
de forma impredecible. Para insertar una medida de seguridad en códigos como 
éste, puede usar el operador checked, como aparece en el listado 4.6. 

Listado 4.6. Verificación de los desbordamientos de las operaciones matemáticas 

class Listing4_6 
{ 

public static void Main() 

{ 

int Int 1 ; 
int Int2; 
int IntlPlusInt2; 

Int1 = 2000000000; 

Int2 = 2000000000; 

IntlPlusInt2 = checked(Intl + Int2); 

System.Consolé.WriteLine(IntlPlusInt2); 



Si compila y ejecuta el listado 4.6 se escribirá un resultado diferente en la 
consola: 

Excepción no controlada: System.OverflowException: La operación 

aritmética ha provocado un desbordamiento, 
at Listing4_l.Main() 

En lugar de escribir un valor matemático sin sentido en la consola, un mensaje 
de desbordamiento permite saber que se intentó comprobar la validez del valor de 
la suma y que la prueba no fue superada. Se informa de una excepción y la 
aplicación concluye. 

La expresión unchecked ( ) es la que se usa por defecto. En las expresiones 
que tienen unchecked ( ) no se comprueba la validez de los valores y la aplica¬ 
ción sigue ejecutándose usando los valores no verificados, aunque no tengan sen¬ 
tido. 

El comportamiento por defecto es el de no verificar las operaciones. Sin em¬ 
bargo. si quiere que se compruebe si todos los valores de sus operaciones son 
válidos sin usar el operador checked ( ) en el código, puede usar la opción / 
checked+ del compilador. Compile el listado 4.1 con la siguiente línea de co¬ 
mando: 

esc /checked+ Listing4-I.cs 

Cuando se ejecuta el ejecutable de listing 4-1, se obtiene el mismo mensaje de 
excepción que se obtuvo con listing 4-2. porque la opción / checkedi obliga a 
comprobar la validez de los valores de todas las operaciones matemáticas. 
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Las expresiones uñarías 


Las expresiones unarias funcionan sobre un solo operando CU admite las 
siguientes expresiones unarias: 

• Unario más operador 

• Unario menos operador 

• Operador de negación lógica 

• Operador de complemento bit a bit 

• Operador de direccionamiento indirecto 

• Operador de direccionamiento 

• Operador de incremento y decrcmento prefijado 

• Expresiones de conversión 

La siguientes secciones tratan estas expresiones uñarías con detalle. 

Cómo devolver valores de operando 
con el operador unario más 

El operador unario más (+) devuelve el valor del operando. Puede pensar en él 
como el operador matemático positivo. CU define el operador unario más para los 
operandos de tipo int. uint, long, ulong, f loat. double y decimal. 

Cómo devolver valores de operando 
con el operador unario menos 

El operador unario menos (-) devuelve el valor del operando. Puede pensar en 
él como el operador matemático negativo. El valor de un operando con un opera¬ 
dor unitario menos es el equivalente negativo del operando CU define el operador 
unario menos para los operandos de tipo int, long. f loat. double y de¬ 
cimal. 

Expresiones negativas booleanas 
con el operador de negación lógica 

El operador de negación lógica niega el valor de una expresión booleana. El 
operador cambia el valor True a False y el valor False a True. Se usa el 
signo de exclamación para escribir un operador de negación lógica en el código 
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C#. El operador se coloca antes de la expresión booleana que quiera negar, como 
se ilustra en el listado 4.7. 

Listado 4.7. Operador de negación lógica 


class MyClass 
! 

public static void Main() 

{ 

bool MyBooiean; 

MyBoolean = true; 

MyBooiean - ¡MyBoolean; // "MyBoolean" ahora es false 

} 

} 

El operador de complemento bit a bit 

C# permite aplicar una operación de complemento bit a bit a expresiones int. 
uintj long y ulong. Las operaciones de complemento bit a bit consideran al 
valor como si fueran un binario y dan la vuelta a todos los bits. 

Los bits que tenían un valor 1 se vuelven 0 y los bits que tenían un valor 0 se 
vuelven 1. 

Los operadores de complemento bit a bit se especifican colocando el carácter 
v irgulilla (-) antes de la expresión que debería ser complementada bit a bit. como 
se ve en el listado 4 8 

Listado 4.8. Operador de complemento bit a bit 


dass MyClass 


pub1 ic sta t 1 c v o i d Main() 


int In t1 f 

Int1 - 123; 
IntI - -Tntl; 



Cómo prefijar operadores de incremento 
y decremento 

Los operadores postfijos ++ y — pueden ser usados en uno de los dos modos. 
Ya ha visto las versiones postfijas de los operadores, que aparece después de la 
expresión. Las versiones prefijas aparecen antes de la expresión, como se ve en el 
listado 4.9. 
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Listado 4.9. Operadores de incremento y decremento prefijados 


class MyClass 
{ 

public static void Main() 

{ 

int Mylnteger; 

Mylnteger = 125; 

++Mylnteger; // el valor ahora es 126 
--Mylnteger; // el valor ahora vuelve a ser 125 


} 

El tipo de una expresión que usa los operadores postfijos de incremento y 
decremento concuerda con el tipo cuyo valor se incrementa o reduce. Tenga en 
cuenta la sutil diferencia entre estos operadores prefijos y los operadores postfijos 
que se vieron con anterioridad: con los operadores prefijos, el valor se cambia 
después de que se evalúe la expresión. El listado 4.10 ilustra esta diferencia. 


Listado 4.10. Diferencias entre operadores postfijos y prefijos 

class Listing4_10 
{ 

public static void Main() 

{ 

int Int1; 

Int1 = 123; 

System.Consolé.WriteLine(Intl++); 

System.Consolé.WriteLine(++Int1); 

} 


Compile y ejecute el listado 4.3. El resultado de esta aplicación aparece en la 
figura 4.2. La primera instrucción del listado 4.10 usa el operador postfijo de 
incremento, lo que significa que el valor se incrementa después de que se ejecute 
la instrucción. La aplicación escribe el valor actual. 123. en la consola y luego 
incrementa el valor a 124. La segunda instrucción usa el operador de incremento 
postfijo, lo que significa que el valor se incrementa antes de que se ejecute la 
instrucción. La aplicación primero incrementa el valor actual a 125 y luego escri¬ 
be el valor actual en la consola. 

Los operadores aritméticos 

Los operadores aritméticos permiten realizar cálculos en el código C#. Las 
expresiones que usan operadores aritméticos son expresiones binarias porque se 
necesitan dos operandos para realizar una operación matemática. 
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Figura 4.2. Uso de operadores prefijos y postfijos 


Cómo asignar nuevos valores con el operador 
de asignación 

El operador de asignación asigna un nuevo v alor a una variable. El signo igual 
se usa como operador de asignación: 

Mylnteger - 3; 

Se establece el valor de Mylnteger en 3 y se pierde el valor anterior de 

MyVariable. 

Los operadores de asignación compuesta permiten usar el operador de asigna¬ 
ción mas de una vez en una instrucción: 

Mylnteger = MyOtherInteger = 3; 

El valor de la expresión a la derecha se usa como el nuevo valor para las 
variables. En este ejemplo, se asigna 3 a Mylnteger y a MyOtherInteger. 

Uso del operador multiplicación 

El valor de una expresión que usa el operador de multiplicación es el producto 
de los valores de los dos operadores. El carácter asterisco se usa como operador 
de multiplicación, como se v e en el listado 4 11 

Listado 4.11. Operador multiplicación 

class MyClass 
{ 

static void Main() 


publ i c 







int Mylnteger; 


Mylnteger - 3 * 6; // Mylnteger sera 18 

} 

} 

Si se está multiplicando un valor por una variable \ colocando el resultado en 
la misma variable, se puede escribir una instrucción abreviada paia realizar la 
multiplicación. Al introducir un asterisco seguido por un signo igual se multiplica 
un valor por una variable y se actualiza el valor de la variable con el resultado. 

Mylnteger *= 3; 

Esta instrucción es la abreviatura de la siguiente: 

Mylnteger = Mylnteger * 3; 

Uso del operador división 

El valor de una expresión que usa el operador de división es el producto de los 
valores de los operadores. La barra inclinada es el carácter que se usa como 
operador de división, como se ve en el listado 4.12. 

Listado 4.12. Operador división (Ejemplo 1) 


class MyClass 
{ 

public static void Main() 

{ 

int Mylnteger; 

Mylnteger =6/3; // Mylnteger será 2 

} 

} 

Si la operación de división da como resultado un resto, el resultado de la 
operación será sólo el cociente (véase el listado 4.13). 

Listado 4.13. Operador división (Ejemplo 2) 

class MyClass 
{ 

public static void Main () 

{ 

int Mylnteger; 

Mylnteger =7/3; 
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Cuando se ejecuta este código, la variable Mylnteger tiene un valor de 2. 
porque si se divide 7 entre 3 queda un cociente de 2 y un resto de 1 

Si se divide un valor entre una variable y se coloca el resultado en la misma 
variable, se puede escribir una instrucción abreviada para realizar la división. 
Escribiendo una barra inclinada seguida por un signo igual se divide un valor 
entre una variable y se actualiza el valor de la variable con el resultado: 

Mylnteger /- 3; 

La instrucción anterior es una abreviatura de la siguiente: 

Mylnteger = Mylnteger / 3; 

Uso del operador resto 

El valor de una expresión que usa el operador de resto es el resto de una 
operación de división El carácter tanto por ciento se usa como el operador de 
división (véase el listado 4 14). 

Listado 4.14. Operador resto 


class MyClass 
{ 

public static void Main() 
{ 

int Mylnteger; 
Mylnteger =7 3; 


} 

Cuando se ejecuta este código, la variable Mylnteger tiene el valor de 1. 
porque si se divide 7 entre 3 queda un cociente de 2 y un resto de 1. 

Si se está calculando un resto usando una variable y se coloca el resultado en 
la misma variable, se puede escribir una instrucción abreviada para realizar la 
operación de resto. Si se escribe un signo de tanto por ciento seguido del signo 
igual se calculara el resto de una variable y se actualizará el valor de la variable 
con el resultado: 

Mylnteger = 3; 

La instrucción anterior es la abreviatura de la siguiente: 

Mylnteger - Mylnteger 3; 

Uso del operador suma 

El valor de una expresión que usa el operador de suma es la suma de los 
valores de los dos operadores. El carácter suma se usa como el operador de 
multiplicación (véase el listado 4.1 5). 
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Listado 4.15. Operador suma 


class MyClass 

{ 

public static void Main() 

{ 

int Mylnteger; 

Mylnteger =3+6; // Mylnteger será 9 

} 

} 

Si se está sumando un valor a una variable y se coloca el resultado en la misma 
variable, se puede escribir una instrucción abreviada que realice la suma. Al 
escribir un signo más seguido de un signo igual se añade un valor a una variable 
v se actualiza el valor de la variable con el resultado: 

Mylnteger + = 3; 

La instrucción anterior es la abreviatura de la siguiente: 

Mylnteger = Mylnteger + 3; 

El operador de suma tiene un significado especial cuando los dos operandos 
son cadenas. La suma de dos cadenas une la primera cadena a la segunda: 

string CombinedString - "Helio from " + "C#"; 

El valor de CombinedSt r ing es Hel lo from C# cuando se ejecuta este 
código. 

Uso del operador resta 

El valor de una expresión que usa el operador de resta es la diferencia de los 
valores de los dos operadores. El carácter guión se usa como el operador de resta 
(véase el listado 4.16). 

Listado 4.16. Operador resta 

class MyClass 

{ 

public static void Main() 

{ 

int Mylnteger; 

Mylnteger =7-3; // Mylnteger será 4 

} 

} 

Si se está restando un valor a una variable y se coloca el resultado en la misma 
variable, se puede escribir una instrucción abreviada que realice la resta. Al es- 
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cribir un signo menos seguido de un signo igual se resta un valor de una variable 
y se actualiza el valor de la variable con el resultado: 

Mylnteger -= 3; 

La instrucción anterior es la abreviatura de la siguiente: 

Mylnteger - Mylnteger - 3; 

Los operadores de desplazamiento 


Los operadores de desplazamiento permiten mover bits de lugar en un valor 
de su codigo C#. Las expresiones que usan los operadores de desplazamiento 
son expresiones binarias porque se necesitan dos operandos para realizar una 
operación de desplazamiento. 

Cómo mover bits con el operador 
de desplazamiento a la izquierda 

El valor de una expresión que usa el operador de desplazamiento a la izquierda 
se mueve a la izquierda la cantidad de bits especificados. Se usan dos caracteres 
menor que (<<) como operadores de desplazamiento a la izquierda (véase el lista¬ 
do 4.17). 


Listado 4.17. Operador de desplazamiento a la izquierda 

class MyClass 

{ 

public static void Main() 

{ 

int Mylnteger; 

Mylnteger - 6 << 3; 

} 

} 

Cuando se ejecuta este código, la variable Mylnteger tiene un valor de 48. 
porque el valor original. 6. es considerado un numero binario con un valor binario 
de ()()()()() 1 10. Cada bit en el valor original se desplaza tres lugares, que es el valor 
que aparece después del operador de desplazamiento a la izquierda v se colocan 
ceros en los bits de orden inferior. Al cambiar cada bit tres lugares da como 
resultado un valor binario de 001 ÍOOOO o 48 en el sistema decimal. 

Se pueden aplicar desplazamientos a la izquierda a los valores de las expresio¬ 
nes de tipo int. uint. long y ulong. También pueden desplazarse a la iz¬ 
quierda otras expresiones que pueden ser convertidas a uno de estos tipos. Las 
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expresiones de tipo int y uint pueden desplazarse hasta 32 bits de una vez. 
Las expresiones de tipo long y ulong pueden ser desplazadas hasta 64 bits de 
una vez. 

Si se está calculando una operación de desplazamiento a la izquierda de un valor 
y una variable, y se coloca el resultado en la misma variable, se puede escribir una 
instrucción abreviada que realice esta operación. Al escribir dos signos menor que 
(«) seguidos por un signo igual se calcula la operación de desplazamiento a la 
izquierda y se actualiza el valor de la variable con el resultado: 

Mylnteger <<= 3; 

La instrucción anterior es la abreviatura de la siguiente: 

Mylnteger = Mylnteger << 3; 

Cómo mover bits con el operador 
de desplazamiento a la derecha 

El valor de una expresión que usa el operador de desplazamiento a la derecha 
se mueve a la derecha la cantidad de bits especificados. Se usan dos caracteres 
mayor que (») como operadores de desplazamiento a la derecha (véase el listado 
4 18). 

Listado 4.18. Operador de desplazamiento a la derecha 

class MyClass 

{ 

public static void Main() 

{ 

int Mylnteger; 

Mylnteger = 48 >> 3; 

} 

} 

Cuando se ejecuta este código, la variable Mylnteger tiene un valor de 6. 
porque el valor original. 48. es considerado un número binario con un valor binario 
de 001 10000. Cada bit en el valor original se desplaza tres lugares, que es el valor 
que aparece después del operador de desplazamiento a la derecha y se colocan 
ceros en los bits de orden superior. El cambiar cada bit tres lugares da como 
resultado un valor binario de 00000110 o 6 decimal. 

Se pueden aplicar desplazamientos a la derecha a los valores de las expresio¬ 
nes de tipo int. uint. long y ulong. También pueden desplazarse a la dere¬ 
cha otras expresiones que pueden ser convertidas a uno de estos tipos. Las 
expresiones de tipo int y uint pueden desplazarse hasta 32 bits de una vez. 
Las expresiones de tipo long y ulong pueden ser desplazadas hasta 64 bits de 
una vez 
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Si está calculando una operación de desplazamiento a la derecha de un valor 
y una variable y colocando el resultado en la misma variable, puede escribir una 
instrucción abreviada que realice esta operación. Escribir dos signos mayor que 
seguidos por un signo igual calcula la operación de desplazamiento a la derecha v 
actualiza el valor de la variable con el resultado: 

Mylnteger >>- 3; 

La instrucción anterior es la abreviatura de la siguiente: 

Mylnteger = Mylnteger >> 3; 

Cómo comparar expresiones con operadores 
relaciónales 

Los operadores relaciónales permiten comparar dos expresiones v obtener un 
valor boolcano que especifica la relación entre las dos expresiones. Las expresio¬ 
nes que usan operadores relaciónales son expresiones binarias porque se necesi¬ 
tan dos operandos para realizar una operación relacional. 

Cómo comprobar la igualdad con el operador 
de igualdad 

El operador de igualdad se usa para comprobar la igualdad entre los valores de 
dos expresiones. Si las expresiones tienen el mismo valor, el operador de igualdad 
devuelve Truc. Si tienen valores diferentes, el operador de igualdad devuelve 
False. Como operador de igualdad se usan dos signos igual: 

Mylnteger -- 123; 

Si el valor de la variable Mylnteger es 123. el operador de igualdad devuel¬ 
ve True. Si tiene otro valor, el operador de igualdad devuelve False. 

El operador de igualdad tiene un significado especial cuando los dos operandos 
son cadenas. Al comparar dos cadenas se comparan los contenidos de las cade¬ 
nas. Dos cadenas se consideran iguales si tienen la misma longitud y los mismos 
caracteres en cada posición de la cadena. 

Cómo comprobar la desigualdad 
con el operador de desigualdad 

El operador de desigualdad se usa para comprobar la desigualdad entre los 
valores de dos expresiones. Si las expresiones tienen diferentes valores, el opera¬ 
dor de desigualdad devuelve True. Si tienen el mismo valor, el operador de 
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desigualdad devuelve False. Como operador de desigualdad se usa un signo de 
exclamación seguido por un signo igual: 

Mylnteger != 123; 

Si el valor de la variable Mylnteger es 123. el operador de desigualdad 
devuelve False. Si tiene otro valor, el operador de desigualdad devuelve True. 

El operador de desigualdad tiene un significado especial cuando los dos 
operandos son cadenas. Al comparar dos cadenas se comparan los contenidos de 
las cadenas. 

Dos cadenas se consideran desiguales si tienen diferentes longitudes o diferen¬ 
tes caracteres en. al menos, una posición de la cadena. 

Cómo comprobar valores con el operador 
menor que 

El operador menor que se usa para comprobar los valores de dos expresiones y 
ver si un valor es menor que el otro. Si la primera expresión tiene un valor menor 
que el de la segunda expresión, el operador menor que devuelve True. Si la 
primera expresión tiene un valor mayor o igual que el de la segunda expresión, el 
operador menor que devuelve False. El operador menor que se representa me¬ 
diante un signo menor que (<): 

Mylnteger < 123; 

Si el valor de la variable Mylnteger es menor de 123. el operador menor 
que devuelve True. Si tiene un valor mayor que o igual a 123. el operador menor 
que devuelve False. 

Cómo comprobar valores con el operador 
mayor que 

El operador mayor que se usa para comprobar los valores de dos expresiones y 
ver si un valor es mavor que el otro. Si la primera expresión tiene un valor mayor 
que el de la segunda expresión, el operador mayor que devuelve True. Si la 
primera expresión tiene un valor menor o igual que el de la segunda expresión, el 
operador mayor que devuelve False. El operador mayor que se representa me¬ 
diante un signo mayor que (<): 

Mylnteger > 123; 

Si el valor de la variable Mylnteger es mayor de 123. el operador mayor 
que devuelve True. Si tiene un valor menor que o igual a 123. el operador menor 
que devuelve False. 
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Cómo comprobar valores con el operador menor 
o igual que 

El operador menor o igual se usa para comprobar los valores de dos expresio¬ 
nes v ver si un valor es menor o igual que el otro. Si la primera expresión tiene un 
valor menor o igual que el de la segunda expresión, el operador menor o igual que 
devuelve True. 

Si la primera expresión tiene un valor mayor que el de la segunda expresión, el 
operador menor o igual que devuelve False. 

Como operador menor o igual que se usa un signo menor que seguido de un 
signo igual (< = ): 

Mylnteger <- 123; 

Si el valor de la variable Mylnteger es menor o igual a 123. el operador 
menor o igual que devuelve True. Si tiene un valor mayor de 123. el operador 
menor o igual que devuelve False. 

Cómo comprobar valores con el operador 
mayor o igual que 

El operador mayor o igual que se usa para comprobar los valores de dos 
expresiones y ver si un valor es mayor o igual que el otro. Si la primera expresión 
tiene un valor mayor o igual que el de la segunda expresión, el operador mayor o 
igual que devuelve True. 

Si la primera expresión tiene un valor menor que el de la segunda expresión, el 
operador mayor o igual que devuelve False. 

Como operador mayor o igual que se usa un signo mayor que seguido de un 
signo igual (>=): 

Mylnteger >= 12 3; 

Si el valor de la variable Mylnteger es mayor o igual a 123. el operador 
mayor o igual que devuelve True. Si tiene un valor menor de 123. el operador 
mayor o igual que devuelve False. 


Operadores lógicos enteros 


Los operadores lógicos enteros permiten realizar operaciones aritméticas 
booleanas sobre dos valores numéricos. Las expresiones que usan operadores 
lógicos enteros son expresiones binarias porque se necesitan dos operandos para 
realizar una operación lógica. 
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Cómo calcular valores booleanos 
con el operador AND 

El operador AND se usa para calcular el valor AND booleano de dos expresio¬ 
nes. Como operador AND se usa el símbolo de unión (&): 

Mylnteger = 6 & 3; 

El valor de Mylnteger es 2. Recuerde que un bit en una operación AND es 1 
sólo si los dos bits operandos de la misma posición son 1 El valor 6 en binario es 
1 10 y el valor 3 en binario es 01 I. Si se realiza un AND booleano de 1 10 y 01 I se 
obtiene como resultado un valor booleano de 010 o 2 en el sistema decimal 

Si se está calculando una operación AND sobre un valor y una variable y se 
coloca el resultado en la misma variable, se puede escribir una instrucción abre¬ 
viada que realice la operación AND. Si se escribe un signo de unión (&) seguido 
de un signo igual se calcula la operación AND sobre una v ariable y un valor, y se 
actualiza el valor de la variable con el resultado: 

Mylnteger &= 3; 

La instrucción anterior es la abreviatura de la siguiente: 

Mylnteger = Mylnteger & 3; 

Cómo calcular valores booleanos 
con el operador exclusivo OR 

El operador exclusivo OR se usa para calcular el valor booleano exclusivo OR 
de dos expresiones. Como operador OR exclusivo se usa el signo de intercalación 
( A ): 


Mylnteger = 6 A 3; 

El valor de Mylnteger es 5. Recuerde que un bit en una operación exclusiva 
OR es 1 sólo si uno de los dos bits operando en la misma posición es 1 El valor de 
6 en binario es 110 y el valor de 3 en binario es 01 1 Si realizamos un booleano 
OR exclusivo entre 110 y 011 obtenemos como resultado un valor booleano de 
101 o 5 en el sistema decimal. 

Si se está calculando una operación OR exclusiva sobre un valor y una varia¬ 
ble v se coloca el resultado en la misma variable, se puede escribir una instruc¬ 
ción abreviada que realice la operación OR exclusiva. Si se escribe un signo de 
intercalación ( A ) seguido de un signo igual se calcula la operación OR exclusiva 
sobre una variable y un valor, y se actualiza el valor de la variable con el resulta¬ 
do: 


Mylnteger A = 3; 
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La instrucción anterior es la abreviatura de la siguiente: 

Mylnteger - Mylnteger A 3; 

Cómo calcular valores booleanos 
con el operador OR 

El operador OR se usa para calcular el valor booleano OR de dos expresiones. 
Como operador OR se usa el carácter barra vertical (|): 

Mylnteger =6 | 3; 

El valor de Mylnteger es 7. Recuerde que un bit en una operación OR es 1 
sólo si uno de los dos bits operandos de la misma posición es 1 El valor 6 en 
binario es 1 10 y el valor 3 en binario es 011. Si se realiza un booleano OR entre 
1 10 y 01 1 se obtiene como resultado un valor de 1 1 1 o 7 en decimal. 

Si se está calculando una operación OR sobre un valor y una variable, y se 
coloca el resultado en la misma variable, puede escribir una instrucción abrevia¬ 
da que realice la operación OR. Si se escribe una barra vertical (|) seguido de un 
signo igual se calcula la operación OR sobre una variable y un valor, v se actua¬ 
liza el valor de la variable con el resultado: 

Mylnteger |= 3 ; 

La instrucción anterior es la abreviatura de la siguiente: 

Mylnteger = Mylnteger | 3; 

Operadores condicionales lógicos 


Los operadores condicionales lógicos son los equivalentes condicionales de 
los operadores lógicos enteros. Las expresiones que usan los operadores condi¬ 
cionales lógicos son expresiones binarias porque se necesitan dos operandos para 
realizar una operación condicional lógica. 

Comparación de valores booleanos 
con el operador AND condicional 

El operador AND condicional se usa para comparar dos expresiones booleanas. 
El resultado de la operación es True si ambos operandos devuelven True y 
False si uno de los dos operandos devuelve False. Como operador AND con¬ 
dicional se usan dos símbolos de unión: 

MyBoolean = true && false; 
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El valor deMyBoolean es False porque uno de los dos operandos devuel¬ 
ve False. 

Comparación de valores booleanos 
con el operador OR condicional 

El operador OR condicional se usa para comparar dos expresiones booleanas. 
El resultado de la operación es True si uno de los dos operandos devuelve True 
v False si los dos operandos devuelven False. Como operador OR condicional 
se usan dos barras verticales: 

MyBoolean = true || false; 

El valor de MyBoolean es True porque uno de los dos operandos devuelve 

True. 

Comparación de valores booleanos 
con el operador lógico condicional 

El operador lógico condicional evalúa una expresión booleana. El resultado de 
la expresión tiene un valor si la expresión de entrada devuelve True y otro si la 
expresión de entrada devuelve False. Las expresiones que usan operadores con¬ 
dicionales son expresiones ternarias porque se necesitan tres operandos para rea¬ 
lizar una operación lógica condicional. El operador condicional es la única expresión 
ternaria admitida por el lenguaje C#. 

Escribir un operador condicional implica escribir la expresión de entrada se¬ 
guida por un signo de interrogación. El valor True aparece después, seguido de 
dos puntos y a continuación seguido por el valor False: 

Mylnteger = {MyVariable -- 123) ? 3: 5; 

Puede interpretar esta instrucción como "Compara el valor de MyVariable 
con 123. Si esa expresión devuelve True. haz que el valor de Mylnteger sea 
3. Si esa expresión devuelve False. haz que el valor de Mylnteger sea 5". 

El orden de las operaciones 


C# permite colocar varios operadores en una sola instrucción: 

MyVariable = 3 * 2 + 1 ; 

¿Cual es el valor de MyVariable aquí. ? Si C# aplica la multiplicación en 
primer lugar, leerá la instrucción como "multiplica 3 por dos y luego añade 1". 
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que da como resultado un valor de 7. Si C# aplica la suma en primer lugar, leerá 
la instrucción como "suma 2 y 1 y luego multiplícalo por 3". que da como resulta¬ 
do un valor de 9. 

C# combina los operadores en grupos y aplica un orden de prioridad a cada 
grupo. Este orden de prioridad especifica qué operadores se evalúan antes que 
otros. La lista con el orden de prioridad de C# es la siguiente, ordenados de mayor 
prioridad a menor: 

• Expresiones primarias 

• Operadores únanos + -!-++ — 

• Operadores multiplicativos * / % 

• Operadores aditivos + - 

• Operadores de desplazamiento « » 

• Operadores relaciónales <><=>= 

• Operadores de igualdad == ! = 

• AND logico 

• OR lógico exclusivo 

• OR lógico 

• AND condicional 

• OR condicional 

• Ternario condicional 

• Operadores de asignación 

Repase la siguiente instrucción: 

MyVanable = 3*2 + 1 

C# da a MyVariable un valor de 7 porque la prioridad del operador de 
multiplicación es superior a la del operador de suma. Esto significa que el opera¬ 
dor de multiplicación se evalúa primero y en segundo lugar el operador suma. 

Se puede invalidar el orden de prioridad con paréntesis. Las expresiones entre 
paréntesis se evalúan antes de que se apliquen las reglas de prioridad de operado¬ 
res: 

MyVariable = 3 * (2+1) 

En este caso. C# da a MyVariable un valor de 9. porque la expresión de 
suma está entre paréntesis, obligando a que se evalúe antes que la operación de 
multiplicación. 
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Resumen 


C# define muchos operadores para ayudarle a evaluar expresiones y a calcular 
nuevos valores a partir de esas operaciones. Este lenguaje permite escribir expre¬ 
siones que realizan funciones matemáticas y booleanas. y compara dos expresio¬ 
nes y obtiene un resultado booleano de esa comparación. 

En este capítulo, se presentan los operadores de C# y se aprende a usar estos 
operadores en expresiones con literales y variables. También se han revisado las 
expresiones de operador v la prioridad al usar estos operadores en expresiones. 
Cuando examinemos las clases en un capítulo posterior, descubrirá que sus clases 
pueden redefinir algunos de estos operadores. A esto se le llama sobrecarga de 
operadores y le permite redefinir la forma en que los operadores calculan los 
resultados. 
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5 


Cómo 
controlar el flujo 

del código 


El comportamiento del código C# a menudo depende de las condiciones que 
se determinan en tiempo de ejecución. Quizás quiera escribir una aplicación que 
salude a sus usuarios con un mensaje de "Buenos dias" si la hora en ese momento 
es inferior a las 12:00 P M . por ejemplo; o "Buenas tardes" si la hora en ese 
momento está entre las 12:00 P.M. y las 6:00 P.M. 

Comportamientos como éste necesitan que el código C# examine valores en 
tiempo de ejecución y realice una acción basada en dichos valores. C# admite 
varias construcciones de código que le permiten examinar variables y realizar 
una o varias acciones basadas en dichas variables. En este capítulo se examinan 
las instrucciones de flujo de control de C# que actuarán como el cerebro de las 
aplicaciones que escriba. 

Instrucciones de C# 


Una instrucción es una expresión válida de C# que define una acción realiza¬ 
da por el código. Las instrucciones pueden examinar valores de variables, asig¬ 
nar nuevos valores a una variable, llamar a métodos, realizar una operación, crear 
objetos o realizar alguna otra acción. 
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La instrucción más corta posible en C# es la instrucción vacía. Ésta consiste 
en sólo el punto y coma: 


Se puede usar la instrucción vacía para decir. M No hagas nada aquí". Esto 
podría no parecer muy útil, pero tiene su función. 


NOTA: Todas las instrucciones de C# terminan en un punto y coma. 


Las instrucciones se agrupan en listas de instrucciones que se componen de 
una o más instrucciones escritas en secuencia: 

int MyVariable; 

MyVariable - 12 3; 

MyVariable + = 234; 

Por lo general, las instrucciones se escriben en su propia línea. Sin embargo. 
CU no exige esta disposición. C# ignora cualquier espacio en blanco entre instruc¬ 
ciones y acepta cualquier disposición siempre que cada instrucción este separada 
por un punto y coma: 

int MyVariable; 

MyVariable = 123; MyVariable += 234 ; 

Las listas de instrucciones se encierran entre llaves. Una lista de instrucciones 
entre llaves recibe el nombre de bloque de instrucciones. Casi siempre usará 
bloques de instrucciones para escribir el código de la función. Toda la lista de 
instrucciones de la función se coloca en un bloque de instrucciones. Es perfecta¬ 
mente posible usar sólo una instrucción en un bloque de instrucciones: 

public static void Main() 

{ 

System.Consolé.WriteLine("Helio!"); 

} 

CU no impone ningún limite al numero de instrucciones que se pueden colocar 
en un bloque de instrucciones. 

Instrucciones para declarar variables locales 

Las instrucciones de declaración declaran variables locales en el código. Ya 
hemos visto varios ejemplos de este tipo de instrucciones. Las instrucciones de 
declaración especifican un tipo y un nombre para un variable local: 

int MyVariable; 
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También se puede inicializar la variable cuando se declara usando un signo 
igual y asignando un valor a la variable: 

int MyVariable = 123; 

C# permite enumerar varias variables en la misma instrucción. Para separar 
los nombres de las variables se usan comas. 

int MyFirstVariable, MySecondVariable; 

Cada variable de la instrucción tiene el tipo especificado. En el ejemplo ante¬ 
rior, MyFirstVariable v MySecondVar iable son de tipo int. 

Las declaraciones de constantes definen una variable cuyo valor no puede 
cambiar durante la ejecución del código. Las declaraciones de constantes usan la 
palabra clave de C# const y deben asignar un valor a la variable cuando se 
declara dicha variable: 

const int MyVariable = 123; 

Las declaraciones de constantes permiten una mejor legibilidad y administra¬ 
ción del código. Se pueden tener valores constantes en el código y al asignarles 
nombres se consigue que el código resulte más legible que si usara su valor. 
Además, si se usan valores por todo el código y luego se necesita cambiarlos, esta 
será una tarea muy pesada. Si se usa una constante, sólo liara falta cambiar una 
linea de código. 

Por ejemplo, suponga que está escribiendo un código para una aplicación que 
realiza medidas geométricas. Uno de los valores con los que querrá trabajar es pi¬ 
la relación entre la circunferencia de un círculo y su diámetro. Sin una declara¬ 
ción de constante, tendría que escribir un codigo de la siguiente forma: 

Area - 3.14159 * Radius * Radius; 

Al usar una constante se logra que el código sea un poco más sencillo de 
entender: 

const double Pi = 3.14159; 

Area = Pi * Radius * Radius; 

Esto es especialmente útil si usa muchas veces en el código el valor de pi. 


Cómo usar instrucciones de selección 
para seleccionar la ruta del código 

Las instrucciones de selección seleccionan una de las muchas rutas posibles 
para que se ejecute el código. La ruta de código seleccionado se basa en el valor 
de una expresión. 
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La instrucción if 

La instrucción if trabaja con una expresión que devuelve un valor booleano 
Si la expresión booleana resulta ser true. la instrucción incrustada en la instruc¬ 
ción if se ejecuta. Si la expresión booleana resulta ser false. la instrucción 
incrustada en la instrucción if no se ejecuta: 

if(MyVariable -- 123) 

System.Consolé.WriteLine("MyVariable's valué is 123."); 

La instrucción booleana se escribe entre paréntesis. La instrucción incrustada 
sigue a los paréntesis. Se usa un punto y coma para cerrar la instrucción incrus¬ 
tada. pero no la expresión booleana. 


NOTA: Cuando se usa la instrucción if para comprobar una igualdad, 
siempre se deben usar dos signos igual. Dos signos igual hacen una com¬ 
probación de igualdad, mientras que un signo igual realiza una asignación. 
Si se usa accidentalmente un signo igual dentro de una instrucción if, ésta 
siempre devolverá un valor true. 


En el anterior ejemplo, el valor de MyVariable se compara con el valor 
literal 123. Si el valores iguala 123. la expresión devuelve true y se escribe el 
mensaje MyVar i ah* e' s valué is 12 3 . en la consola. Si el valor no es 
igual a 123. la expresión devuelve false y no se escribe nada. 

La instrucción i f puede ir seguida de una cláusula else. La palabra clave 
el se va seguida de una instrucción incrustada que se ejecuta si la expresión 
booleana usada en la cláusula if devuelve false: 

if(MyVariable == 123) 

System.Consolé.WriteLine("MyVariable's valué is 123."); 

else 

System.Consolé.WriteLine("MyVariable's valué is not 123."); 

En el anterior ejemplo, el valor de MyVariable se compara con el valor 
literal 1 23. Si el valor es igual a 123. la expresión devuelve true y se escribe el 
mensaje MyVariable' s valué is 123. en la consola. Si el valor no es 
igual a 123. la expresión devuelve false y se escribe el mensaje 
MyVariable's valué is not 123. en la consola. 

La cláusula else puede ir seguida por su propia cláusula if: 

if (MyVariable = = 123) 


System.Consolé.WriteLine( 
else if (M yV a ri a b1e = = 124) 

"MyVariable' s 

valué 

is 

123 

System.Consolé.WriteLine( 
else 

"MyVariable' s 

valué 

is 

124 

System.Consolé.WriteLine("MyVariable's 

valué 

is 

not 
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Las cláusulas if y else permiten asociar una instrucción a la cláusula. Por 
lo general. C# permite asociar sólo una instrucción a la cláusula, como se ve en el 
siguiente código: 

if(MyVariable = = 123) 

System.Consolé.WriteLine("MyVariable' s valué is 123."); 

System.Consolé.WriteLine("This always prints."); 

La instrucción que escribe This always prints . en la consola siempre 
se ejecuta. No pertenece a la cláusula if y se ejecuta independientemente de si el 
v alor de MyVar iable es 123. La única instrucción que depende de la compara¬ 
ción de MyVariable con 123 es la instrucción que escribe MyVariable' s 
valué is 12 3 . en la consola. Si se quiere asociar varias instrucciones con 
una cláusula if. se debe usar un bloque de instrucciones: 

if (MyVariable == 123) 


System.Consolé.WriteLine("MyVariable's valué is 123."); 
System.Consolé.WriteLine("This prints if MyVariable =- 
12 3 . ") ; 

} 


También se pueden usar bloques de instrucciones en las cláusulas else: 

if (MyVariable == 123) 


System. Consolé.WriteLine("MyVariable's valué is 123."); 
System.Consolé.WriteLine("This prints if MyVariable == 

12 3.") ; 

) 

else 

{ 

System. Consolé.WriteLine("MyVariable's valué is not 123."); 
System.Consolé.WriteLine("This prints if MyVariable != 
123.") ; 

} 


Como los bloques de instrucciones pueden contener una sola instrucción, el 
siguiente código también es valido: 

if(MyVariable == 123) 

{ 

System. Consolé.WriteLine("MyVariable' s valué is 123."); 

} 


La instrucción switch 

La instrucción switch evalúa una expresión y compara el valor de esa ex¬ 
presión con varios casos. Cada caso se asocia con una lista de instrucciones, que 
recibe el nombre ác sección de switch. C# ejecuta la lista de instrucción asociada 
con la sección de switch que concuerde con el valor de la expresión. 
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La expresión usada como controlador de la instrucción switch se encierra 
entre los paréntesis que siguen a la palabra clave switch. La expresión va 
seguida por llaves y las secciones de sw itch están entre las llaves. 

switohfMyVari a b1e ) 


// aquí se colocan las secciones de switch 

} 


La expresión usada en la instrucción switch debe evaluar uno de los siguien¬ 
tes tipos: 


• s b y t e 

• byte 

• s h o r t 

• u s h o r t 

• int 

• uint 

• long 

• ulong 

• char 

• s t r i n g 

También se puede usar una expresión cuyo valor pueda ser convertido implíci¬ 
tamente a uno de los tipos de la lista anterior. 

Las secciones de switch empiezan con la palabra clave de C# case, seguida 
de una expresión constante. A esa expresión constante le siguen dos puntos y a 
continuación escribimos la lista de instrucciones: 

switch(MyVariable ) 

{ 

case 123: 

System. Consolé .WriteLine ( "MyVanable == 123"); 

brea k; 

} 


C# evalúa la expresión en la instrucción switch y luego busca un bloque 
switch cuya expresión constante concuerde con el valor de la expresión. Si C# 
puede encontrar un valor similar en una de las secciones de switch. la lista de 
instrucciones de la sección ác switch se ejecuta. Una instrucción switch puede 
incluir muchas secciones de switch. cada una con un caso diferente: 

switch (MyVanable) 

i 
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12 3") ; 


case 123: 

System.Consolé.WriteLine("MyVariable == 
break; 
case 124: 

System. Consolé . WriteLine ( "MyVariable == 124"); 

break; 
case 125: 

System.Consolé.WriteLine("MyVariable == 125"); 

break; 


C# permite agrupar varias etiquetas de caso juntas. Si se tiene más de un 
caso que necesite ejecutar la misma lista de instrucciones, se pueden combinar 
las etiquetas de caso: 

switch(MyVariable) 

{ 

case 123: 
case 124: 

System.Consolé.WriteLine("MyVariable == 123 or 124"); 

break; 
case 125: 

System.Consolé.WriteLine("MyVariable == 125"); 

break; 


Una de las etiquetas de caso puede ser la palabra clave de C# default. La 
etiqueta default puede incluir su propia lista de instrucciones: 

switch(MyVariable) 

{ 

case 123: 

System.Consolé.WriteLine("MyVariable == 123"); 

break; 
default : 

System.Consolé.WriteLine("MyVariable != 123"); 

break; 


La lista de instrucciones default se ejecuta cuando ninguna de las otras sec¬ 
ciones de switch define alguna constante que concuerde con la expresión swit¬ 
ch. La lista de instrucciones default es la parte que dice "Si no puedes encontrar 
algún bloque switch que concuerde, ejecuta este código por defecto". El uso de la 
palabra clave default es opcional en sus instrucciones de switch. 

Cómo usar instrucciones de iteración 
para ejecutar instrucciones incrustadas 

Las instrucciones de iteración ejecutan instrucciones incrustadas varias ve¬ 
ces. La expresión asociada con la instrucción de iteración controla el numero de 
veces que se ejecuta una instrucción incrustada. 
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La instrucción while 

La instrucción while ejecuta una lista de instrucciones incrustada siempre 
que la expresión while resulte ser trué. La expresión booleana que controla la 
instrucción while se encierra entre los paréntesis que siguen a la palabra clave 
while. Tras los paréntesis situamos las instrucciones que se ejecutaran si la 
expresión booleana es true: 

int MyVariable = 0; 

while(MyVariable < 10) 

{ 

System.Consolé.WriteLine(MyVariable); 

MyVariable++; 

} 


El código escribe en la consola: 

o 

i 


4 

5 

6 

7 

8 
5 

El código incrustado en la instrucción while continua ejecutándose siempre 
que el valor de MyVariable sea menor que 10. Las instrucciones incrustadas 
escriben el valor de MyVariable en la consola y luego incrementan su valor. 
Cuando el valor de MyVariable alcanza 10, la expresión booleana MyVariable 
< 10 devuelve false y la lista de instrucciones incrustada en la instrucción 
while deja de ejecutarse. 

La instrucción que sigue a la instrucción while se ejecuta en cuanto la expre¬ 
sión booleana de la instrucción while devuelve false. 

La instrucción do 

La instrucción while ejecuta sus instrucciones incrustadas cero o más veces. 
Si la expresión booleana usada en la expresión while devuelve false. ninguna 
de las instrucciones incrustadas se ejecuta: 

int MyVariable = 100; 

while(MyVariable < 10) 

{ 

System.Consolé.WriteLine(MyVariable); 

MyVar i able-t- + ; 

} 
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Este código no escribe nada en la consola porque la expresión booleana usada 
en la instrucción while. MyVariable < 10. devuelve false la primera vez 
que se ejecuta. Como la expresión booleana devuelve false inmediatamente, las 
instrucciones incrustadas nunca se ejecutan. Si quiere asegurarse de que las ins¬ 
trucciones incrustadas se ejecuten al menos una vez. puede usar la instrucción 
do. La instrucción do va seguida de instrucciones incrustadas, que a su vez van 
seguidas de la palabra clave while. Tras ella va la expresión booleana que 
controla el número de veces que se ejecuta el bucle: 

int MyVariable = 0; 
do 


System.Consolé.WriteLine(MyVariable); 
MyVariable++; 


while(MyVariable < 10); 

Este código escribe lo siguiente en la consola: 

o 

1 

2 

3 

4 

5 

6 

7 

8 
9 


Las sentencias incrustadas siempre se ejecutan al menos una vez debido a que 
la expresión booleana se evalúa después de que se ejecuten las instrucciones in¬ 
crustadas. como se puede ver en el siguiente código: 

int MyVariable = 100; 


do 


System.Consolé.WriteLine(MyVariable); 

MyVariable+ +; 

} 

while(MyVariable < 10); 

Este código escribe lo siguiente en la consola: 

100 

La instrucción for 

La instrucción for es la instrucción de iteración más potente. El código de 
control de una instrucción for se divide en tres partes: 
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• Un iniciador . que fija las condiciones iniciales de la instrucción de bucle 

for. 

• Una condición, que especifica la expresión booleana que mantiene ejecu¬ 
tándose la instrucción for. 

• Un iterados que especifica las instrucciones que se ejecutan al final de 
cada paso por las instrucciones incrustadas. 

La instrucción for empieza con la palabra clave for. seguida por paréntesis, 
que contienen las instrucciones iniciadora, de condición y de iteración, todas sepa¬ 
radas por puntos y coma. Las instrucciones incrustadas siguen a los paréntesis. 
Observe el siguiente bucle simple for: 

int MyVariable; 

for (MyVari able = 0; MyVariable < 10; MyVariable + +) 

{ 

System. Consolé .WriteLme (MyVariable ) ; 

} 


El iniciador en este bucle for es la instrucción MyVariable = 0. El 

iniciador solo se ejecuta una vez en un bucle for y se ejecuta antes de que las 
instrucciones incrustadas se ejecuten por primera vez. 

La condición de este bucle for es la instrucción MyVariable < 10. La 
condición en un bucle for debe ser una expresión booleana. Las instrucciones 
incrustadas de un bucle for se ejecutan mientras esta expresión booleana devuel¬ 
ve true. Cuando la expresión devuelve false. las instrucciones incrustadas 
dejan de ejecutarse. 

El iterador de este bucle for es la instrucción MyVariable++. El iterador 
se ejecuta después de cada paso por las instrucciones incrustadas del bucle for. 

Si se pone toda esta información junta, se podra interpretar la instrucción 
como: "Fi|a el valor de MyVariable igual a cero. Mientras el valor de 
MyVariable sea menor de 10. escribe el valor en la consola y luego aumenta el 
valor de MyVariable". Estas instrucciones escriben lo siguiente en la consola: 

o 

i 

3 

4 

b 

r 

7 

o 


El iniciador, la condición y el iterador de un bucle for son opcionales. Si 
prefiere no usar alguna de estas partes, simplemente escriba un punto y coma sin 
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especificar la instrucción. El siguiente código es. en buena lógica, equivalente al 
código anterior: 

int MyVariable = 0; 

for(; MyVariable < 10; MyVariable + +) 

{ 

System.Consolé.WriteLine(MyVariable); 

} 

Este código también es equivalente al código original: 

int MyVariable; 

for(MyVariable = 0; MyVariable < 10; ) 

{ 

System.Consolé.WriteLine(MyVariable); 

MyV ariable + +; 

} 

Hav que tener cuidado cuando se omita la parte de la condición en un bucle 
for. El siguiente código es un ejemplo de los problemas que pueden surgir si no 
se incluyen condiciones: 

int MyVariable; 

for(MyVariable = 0; ; MyVariable++) 

{ 

System.Consolé.WriteLine(MyVariable); 

} 

Este código se ejecuta hasta que MyVariable finalmente provoca un error 
porque contiene un número demasiado largo para ser almacenado. Esto ocurre 
porque ninguna condición del bucle for llega a devolver false. lo que permite 
a la variable aumentar hasta superar su límite. Las condiciones que faltan devuel¬ 
ven true en un bucle for. Como la condición en el código anterior de ejemplo 
siempre es true. nunca devuelve false y la instrucción for nunca deja de 
ejecutar su instrucción incrustada. 

Las expresiones iniciadoras, de condición y de iteración pueden contener va¬ 
nas instrucciones, separadas por comas. El siguiente código es válido: 

int MyFirstVariable; 
int MySecondVariable ; 

for(MyFirstVariable = 0, MySecondVariable = 0; 

MyFirstVariable < 10; 

MyFirstVariable++ , MySecondVariable++) 

{ 

System.Consolé.WriteLine(MyFirstVariable); 

System.Consolé.WriteLine(MySecondVariable ) ; 

} 
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La instrucción foreach 


Se puede usar la instrucción foreach para repetir varias veces los elemen¬ 
tos de una colección. Las matrices de C# admiten la instrucción foreach v 
pueden usarse para trabajar fácilmente con cada elemento de la matriz. 

La instrucción foreach se usa escribiendo la palabra clave foreach se¬ 
guida de paréntesis. Estos paréntesis deben contener la siguiente información: 

• El tipo del elemento de la colección. 

• Un nombre identificador para un elemento de la colección. 

• La palabra clave in. 

• El identificador de la colección. 

Tras los paréntesis se colocan las instrucciones incrustadas. 

El listado 5.1 muestra la instrucción foreach en acción Crea una matriz 
entera de cinco elementos y luego usa la instrucción foreach para acudir a cada 
elemento de la matriz y escribir su valor en la consola. 

Listado 5.1. Usando la instrucción foreach 

class Listing5_l 
{ 

public static void Main() 

{ 

int [] MyArray; 

MyArray = new int [5]; 

MyArray[0] = 0; 

MyArray[1] = 1; 

MyArray[2] = 2; 

MyArray[3] = 3; 

MyArray[4] = 4; 

foreach{int ArrayElement in MyArray) 

System.Consolé.WriteLine(ArrayElement); 


} 

El identificador ArrayElement es una variable definida en el bucle 
foreach. Contiene el valor de un elemento de la matriz. El bucle foreach 
recorre cada elemento de la matriz, lo que es muy útil cuando se necesita trabajar 
con cada elemento de una matriz sin tener que conocer el tamaño de la misma. 

Instrucciones de salto para moverse por el código 

Las instrucciones de salto saltan hacia una parte específica del codigo. Siem¬ 
pre se ejecutan y no están controladas por ninguna expresión boolcana. 
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La instrucción break 


Ya vio la instrucción break en la sección dedicada a las instrucciones swit- 
ch. C# también permite usar la instrucción break para salir del bloque de ins¬ 
trucciones en el que se encuentre. Normalmente, la instrucción break se usa 
para salir de un bloque de instrucciones iterativas: 

int MyVariable = 0; 

while(MyVariable < 10) 

{ 

System. Consolé .WriteLme (MyVariable) ; 

if (MyVariable == 5) 

break; 

MyVariable++; 

} 

System. Consolé .WriteLine ("Out of the loop.”)/’ 

El código anterior escribe lo siguiente en la consola: 

o 

1 

2 

3 

4 

Out of the loop. 

El código se interpreta: "Si el valor de MyVariable es 5. sal del bucle 
while”. Cuando se ejecuta la instrucción break. C# transfiere el control a la 
instrucción que sigue a las instrucciones incrustadas de la instrucción de itera¬ 
ción. La instrucción break suele usarse con bloques de instrucciones switch. 
while. do, for y foreach. 

La instrucción continué 

La instrucción continué devuelve el control a la expresión booleana que 
controla una instrucción de iteración, como se puede ver en el siguiente código: 

int MyVariable; 

for(MyVariable = 0; MyVariable < 10; MyVariable++) 

{ 

if(MyVariable == 5) 

continué; 

System.Consolé.WriteLine(MyVariable); 

} 

El código anterior escribe lo siguiente en la consola: 

o 

i 
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3 

4 

6 

7 

8 

5 

Este codigo interpreta: "Si el valor de MyVariable es 5, continúa hasta la 
siguiente iteración del bucle for sin ejecutar ninguna otra instrucción incrusta¬ 
da”. Por eso no aparece el 5 en pantalla. Cuando el valor de MyVariable es 5. 
el control regresa a la parte superior del bucle for y la llamada a WriteLine ( ) 
nunca se produce en esa iteración del bucle for. 

Al igual que la instrucción break. la instrucción continué suele usarse en 
los bloques de instrucciones switch. while. do. for y foreach. 

La instrucción goto 

La instrucción goto transfiere sin condiciones el control a una instrucción 
etiquetada. Puede etiquetarse cualquier instrucción de C#. Las etiquetas de ins¬ 
trucciones son identificadores que preceden a una instrucción. Después de una 
etiqueta de instrucción se colocan dos puntos. Un identifícador de etiqueta sigue a 
la palabra clave goto y la instrucción goto transfiere el control a la instrucción 
designada por el identifícador de etiqueta, como muestra el siguiente código: 

mt MyVariable = 0; 

while(MyVariable < 10) 

{ 

System.Conso le.WriteLine (MyVariable) ; 

if (MyVariable == 5) 
goto Done; 

MyVariable++; 

} 

Done: System.Consolé.WriteLine("Out of the loop".); 

El código anterior escribe lo siguiente en la consola: 

o 

i 

3 

4 

Out of the loop. 

Cuando el valor de MyVariable es 5. la instrucción goto se ejecuta v 
transfiere el control a la instrucción con la etiqueta Done. La instrucción goto 
siempre se ejecuta, independientemente de la instrucción de iteración que pueda 
estar ejecutándose. 

También se puede usar la palabra clave goto en conjunción con las etiquetas 
de caso en una instrucción switch. en lugar de una instrucción break: 
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switch(MyVariable) 


case 123: 

System.Consolé.WriteLine("MyVariable == 123"); 

goto case 12 4; 
case 124: 

System.Console.WriteLine("MyVariable -- 124") ; 

break; 


NOTA; Usar la instrucción goto en muchos sitios puede hacer el código 
confuso e ilegible. Lo mejor es evitar usar una instrucción goto siempre 
ques 

uso de una insfrucción goto. 


Cómo usar instrucciones para realizar cálculos 
matemáticos con seguridad 

Ya ha visto cómo las palabras clave checked y unchecked permiten con¬ 
trolar el comportamiento de las condiciones de error en sus expresiones matemá¬ 
ticas. También se pueden usar estas palabras clave como instrucciones para 
controlar la seguridad de sus operaciones matemáticas. Use las palabras clave 
antes de un bloque de instrucciones al que afecte la palabra reservada checked 
o unchecked. como en el siguiente código: 


checked 

{ 

Intl = 2000000000; 

Int2 = 2000000000; 

IntlPlusInt2 = Intl + Int2; 

System. Consolé.WriteLine(IntIPlusInt2); 

} 

Resumen 


C# dispone de varios medios de controlar la ejecución del código, dándole 
opciones para ejecutar un bloque de código más de una vez o. a veces, ninguna 
vez. basándose en el resultado de una expresión booleana. 

La instrucción if ejecuta el código una vez. pero sólo si la expresión booleana 
que la acompaña devuelve true. La instrucción if puede incluir una cláusula 
else. que ejecuta un bloque de código si la expresión booleana devuelve f alse. 

La instrucción switch ejecuta uno de los muchos bloques de código posi¬ 
bles. Cada bloque de código viene precedido de una lista de instrucciones de caso. 
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C# evalúa la expresión de la instrucción switch y a continuación busca una 
lista de instrucciones de caso cuyo valor coincida con la expresión evaluada en la 
instrucción switch. 

Las instrucciones while. do y f or continúan ejecutando el código mientras 
la expresión booleana indicada sea trué. Cuando la expresión booleana devuel¬ 
ve false. las instrucciones incrustadas dejan de ejecutarse. Las instrucciones 
while y for se pueden definir para que sus expresiones booleanas devuelvan 
inmediatamente false. lo que quiere decir que sus instrucciones incrustadas 
nunca llegan a ejecutarse realmente. La instrucción do, sin embargo, siempre 
ejecuta sus instrucciones incrustadas al menos una vez. 

La instrucción foreach proporciona un buen modo de recorrer repetida y 
rápidamente los elementos de una matriz. Puede ordenar a un bucle foreach 
que recorra repetidamente los elementos de una matriz sin conocer el tamaño de 
la matriz o los elementos que la forman. La instrucción foreach prepara un 
identificador especial formado por el valor del elemento de una matriz durante 
cada iteración del bucle foreach. 

Las instrucciones break. continué y goto afectan al flujo normal de una 
instrucción de iteración, como while o foreach. La instrucción break sale 
del bucle iterativo, incluso si la expresión booleana que controla la ejecución del 
bucle sigue devolviendo true. La instrucción continué devuelve el control a 
la parte superior del bucle iterativo sin ejecutar ninguna de las instrucciones 
incrustadas que la siguen. La instrucción goto siempre transfiere el control a la 
instrucción etiquetada. 

Puede acompañar sus operaciones matemáticas con instrucciones checked o 
unchecked para especificar cómo quiere tratar los errores matemáticos del 
código CU. 
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Cómo 
trabajar 
con métodos 


Los métodos son bloques de instrucciones que devuelven algún tipo de valor 
cuando se ejecutan. Pueden ser llamados mediante el nombre y llamar a un méto¬ 
do hace que las instrucciones del método se ejecuten. Ya hemos visto un método: 
el método Main () . Aunque C# permite poner todo el código en el método Main (). 
probablemente quiera diseñar sus clases para definir más de un método. El uso de 
métodos mantiene el código legible porque las instrucciones se colocan en bloques 
más pequeños, en lugar de en un gran bloque de código. Los métodos también 
permiten tomar instrucciones que pueden ser ejecutadas varias veces y colocarlas 
en un bloque de código que puede ser llamado todas las veces que haga falta. 

En este capitulo, aprenderá a crear funciones que dev uelven datos y que no los 
devuelven. Aprenderá a pasar parámetros a los métodos y la mejor manera de 
estructurar un método para hacer sus aplicaciones modulares. 

La estructura de un método 

Como mínimo, un método está compuesto de las siguientes partes: 

• Tipo devuelto 

• Nombre del método 



• Lista de parametros 

• Cuerpo del método 

NOTA: Todos los métodos se encierran en úna clase. Un método no pue¬ 
de existir foera de una clase. 


Los métodos tienen otras partes opcionales, como las listas de atributos v los 
modificadores de ámbito. Las siguientes secciones analizan los fundamentos de 
un método. 

Tipo devuelto 

Un método comienza definiendo el tipo de datos que devolverá cuando se le 
llame. Por ejemplo, suponga que quiere escribir un método que suma dos números 
enteros y devuelve el resultado. En esc caso, escribirá el tipo devuelto como int. 

C# permite escribir un método que no devuelve nada. Por ejemplo, puede es¬ 
cribir un método que simplemente escriba algún texto en la consola, pero que no 
calcule ningún dato que deba devolver al código que llamó al método. En ese 
caso, se puede usar la palabra clave void para indicar al compilador de C# que 
el método no devuelve ningún dato. 

Si se quiere devolver un valor de un método se usa la palabra clave return 
para especificar el valor que debe devolverse. La palabra clave va seguida de una 
expresión que evalúa el tipo de valor que debe devolverse. Esta expresión puede 
ser un valor literal, una variable o una expresión más compleja. 

Nombre del método 

Todos los métodos deben tener un nombre. Un nombre de método es un 
identificador y los nombres de método deben seguir las reglas de nomenclatura de 
cualquier identificador. Recuerde que los identifícadores deben empezar con una 
letra mayúscula o minúscula o con un carácter subrayado. Los caracteres que 
siguen al primer carácter pueden ser una letra mayúscula o minúscula, un número 
o un subrayado. 

Lista de parámetros 

Se puede llamar a métodos con los parámetros que se usan para pasar los datos 
al método. En el ejemplo anterior, en el que un método suma dos números enteros, 
se necesitaría enviar al método los valores de los dos números enteros que se van 
a sumar. La lista de variables recibe el nombre de lista de parámetros del método. 
La lista de parametros del método aparece entre paréntesis y sigue al nombre del 
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método. Cada parámetro de la lista de parámetros está separado por una coma e 
incluye el tipo del parámetro seguido por su nombre. 

También se puede prefijar los parámetros de la lista de parámetros con modi¬ 
ficadores que especifican cómo se usan sus valores dentro del método. Veremos 
estos modificadores más adelante en este mismo capítulo. 

Se pueden definir métodos que no reciben ningún parámetro. Si se quiere utili¬ 
zar uno de estos métodos, basta con dejar vacíos los paréntesis. Ya hemos visto 
esto en los métodos Main ( ) escritos. También se puede colocar la palabra clave 
void entre los paréntesis para especificar que el método no acepta parámetros. 

Cuerpo del método 

El cuerpo del método es el bloque de instrucciones que compone el código del 
método. El cuerpo del método está entre llaves. La llave de apertura se incluve 
tras la lista de parámetros del método y la llave de cierre se coloca detrás de la 
última instrucción del cuerpo del método. 

Cómo llamar a un método 


Para llamar a un método, se escribe su nombre en el lugar donde debería 
ejecutarse el código de ese método. Después del nombre del método se escriben 
dos paréntesis, como se muestra en el listado 6.1. Como en todas las instrucciones 
de C#. la instrucción de llamada al método debe terminar con un punto y coma. 

Listado 6.1. Llamar a un método simple 

class Listing6_l 
{ 

public static void Main() 

{ 

Listing6_l MyObject; 

MyObject = new Listing6_l(); 

MyObject.CallMethod () ; 

} 


void CallMethod() 

{ 

System.Consolé.WriteLine("Helio from CallMethod() ! ) , 

} 


NOTA: Necesita las instrucciones de Main () qué crean un nuevo obje- 
to Listing6_l antes de poder llamar a los métodos del objeto. 
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Si el método se define con una lista de parámetros, sus valores deben ser 
especificados en el momento de llamar al método. Debe especificar los parámetros 
en el mismo orden en que son especificados en la lista de parámetros del método, 
como muestra el listado 6 . 2 . 

Listado 6.2. Llamada a un método con un parámetro 

class Listing6_2 
{ 

public static void Mam() 

{ 

int Mylnteger; 

Listing6_2 MyObject; 

MyObject = new Listingo 2(); 

MyObject.CallMethod(2); 

Mylnteger = 3; 

MyObj ect.CallMethod(Mylnteger) ; 

} 

void CallMethod(int Integer) 

{ 

System.Consolé.WriteLine (Integer) ; 

} 

} 


Cuando compile y ejecute el listado 6.2 obtendrá un resultado igual al de la 
figura 6 I 



Figura 6.1. Una simple llamada a un método devuelve este resultado 


Esto es debido a que el método Main () llama a CallMethod ( ) dos veces: 
una con el valor 2 y otra con el valor 3. El cuerpo del método CallMethod ( ) 
escribe el valor suministrado en la consola. 




Cuando suministramos un valor para el parámetro de un método, podemos 
usar un valor literal como el 2 del listado 6.2 o suministrar una variable y usar su 
valor, como en la variable Mylnteger del listado 6.2. 

Cuando se llama a un método. C# toma el valor especificado y asigna esos 
valores a los parámetros que se usan en el método. Durante la primera llamada a 
CallMethod ( ) en el listado 6.2. el literal 2 se usa como el parámetro del 
método v el parámetro Integer del método recibe el valor 2. Durante la segun¬ 
da llamada a CallMethod ( ) en el listado 6.2. la variable Mylnteger se usa 
como el parámetro del método y el parámetro Integer del método recibe el 
valor de la variable Mylnteger: 3. 

Los parámetros que se especifican cuando se llama a un método deben concor¬ 
dar con los tipos especificados en la lista de parámetros. Si un parámetro de la 
lista de parámetros del método especifica un tipo int. por ejemplo, los parámetros 
que le pase deberán ser de tipo int o de un tipo que pueda ser convertido a int. 
Cualquier otro tipo produce un error al compilar el código. 

C# es un lenguaje de tipo seguro, lo que significa que se comprueba la legali¬ 
dad de los tipos de variables al compilar el código C#. Por lo que respecta a los 
métodos, esto significa que deben especificarse los tipos correctos cuando se 
especifican parámetros. 

El listado 6.3 muestra los tipos correctos durante la especificación de parámetros: 

Listado 6.3. Seguridad de tipos en listas de parámetros de método 

class Listing6_3 

{ 

public static void Main{) 

{ 

Listing6_3 MyObject; 

MyObject = new Listing6_3(); 

MyObject.CallMethod { "a string") ; 

} 


void CallMethod(int Integer) 

{ 

System.Consolé.WriteLine(Integer); 

} 

} 

Este código no se compila, como puede verse en la figura 6.2. 

El compilador de C# emite estos errores porque el método CallMethod ( ) 
se está ejecutando con un parámetro de cadena y la lista de parámetros 
CallMethod ( ) especifica que se debe usar un número entero como parámetro. 
Las cadenas no son números enteros ni pueden ser convertidas a números enteros 
y esta discordancia hace que el compilador de C# genere errores. 

Si el método devuelve un valor, debe declararse una variable que contenga el 
valor devuelto. La variable usada para esta operación se coloca antes del nombre 
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del método y un signo igual separa el identificado!* de la variable y el nombre del 
método, como se ve en el listado 6.4. 


ca C:\WIfSDOWS\System32\cmd.exe 

C:\>csc CIassl.cs 

Compilador de Microsoft <K> Uisual Ctt .NET 
para Microsoft <R> .HET Franework versión 
(C) Microsoft Microsoft Corporation 2001. 


versión 7 
1.0.3706 
Reservados 


mmr't 


.00.9466 
todos los 


derechos. 


■=13121 


Classl.es<8,3> : error CS1502: La mejor coincidencia de método sobrecargado para 
* List ing6._3 . CallMet hodC in t V tiene ¿algunos argumentos no válidos 
Classl.es<8,23>: error CS1503: Argumento '1': no se puede convertir de f string J 
a ' int' 


C:\> 




Figura 6.2. La llamada a un método con un tipo de datos no válido produce errores 

de compilación. 


Listado 6.4. Devolución de un valor de un método 


class Listmgt 4 
¡ 


\ 

public stdtic 

void Main() 

1 

ListingC 4 

MyObj ect; 


int ReturnValue; 

MyObject - new Listing6_4{); 

ReturnValue - MyObject.Addlntegers(3, 5); 

System.Consolé.WriteLine(ReturnValue); 

} 

int Addlntegers(int Integerl, int Integer2) 

{ 

int Sum; 

Sum = Integerl + Integer2; 
return Sum; 


En este código suceden varias cosas: 

• Se declara un método llamado Addlntegers { ) . El me ; todo tiene dos 
parámetros en su lista de parámetros: un número entero llamado Integerl 
y otro número entero llamado Integer2. 
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• El cuerpo del método Addlntegers () suma los valores de los dos 
parámetros v asigna el resultado a una variable local llamada Sum. Se 
devuelve el valor de Sum. 

• El método Main ( ) llama al método Addlntegers ( ) con los valores 3 
y 5. El valor devuelto del método Addlntegers { ) se coloca en una 
variable local llamada ReturnValue. 

• El valor de ReturnValue se escribe en la consola. 

La figura 6.3 contiene los resultados del programa que aparece en el listado 6.4. 


cÁ C:\WINDOWS\5ystem32\cmd.eHe 

C: \ > L is t in gf> _4. e xe 



C:\>_ 


-JOJ Xj 


▲ 


Id 


Figura 6.3. Los datos se devuelven de un método y se muestran en la ventana 

de la consola. 


Tipos de parámetros 

C# permite cuatro tipos de parámetros en una lista de parámetros: 

• Parámetros de entrada 

• Parámetros de salida 

• Parámetros de referencia 

• Matrices de parámetros 


Parámetros de entrada 

Los parámetros de entrada son parámetros cuyo valor es enviado al método. 
Todos los parámetros que se han usado hasta ahora han sido parámetros de entra- 
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da. Los valores de estos parámetros de entrada se envían a la función, pero el 
cuerpo del método no puede cambiar permanentemente sus valores. 

El listado 6.4 del anterior ejemplo define un método con dos parámetros de 
entrada: Integerl y Integer2. Los valores de estos parámetros se introdu¬ 
cen en el método, que lee sus valores y hace su trabajo. Los parámetros de entrada 
se pasan a los métodos por valor. Básicamente, el método ve una copia del valor 
del parámetro, pero no se le permite cambiar el valor proporcionado por la parte 
que realiza la llamada. En el listado 6.5 se puede ver un ejemplo. 

Listado 6.5. Cómo modificar copias de parámetros de entrada 

class Listing6_5 
{ 

public static void Main (4 
{ 

int MyTnteger; 

Listing6_5 MyObject; 

MyObject = new Listingo_5 ( ) ; 

Mylnteger = 3; 

MyObj «ct.CallMethod(Mylntege r| ; 

System.Consolé.WriteLine(Mylnteger); 

} 


void CallMethod(int Integerl) 
i 

Integerl = 6; 

S ys t em.Consolé.WriteLine (Integerl) ; 



En el listado 6.5. el método Main ( ) establece una variable entera llamada 
MyTnteger y le asigna el valor de 3. A continuación llama a MyMethod ( ) 
con Mylnteger como parámetro. El método CallMethod ( ) establece el va¬ 
lor del parámetro en 6 y luego escribe el valor en la consola. Cuando el método 
Cal lMethod ( ) se devuelve, el método Main ( ) continúa y escribe el valor de 
Mylnteger. Si ejecuta este código, el resultado debería parecerse al de la figu¬ 
ra 6.4. Este resultado se produce porque el método Cal lMethod ( ) modifica su 
copia del parámetro de entrada, pero esa modificación no afecta al valor del 
método original proporcionado por Main ( ) . El valor de Mylnteger sigue 
siendo 3 después de que regrese el método CallMethod () . debido a que 
CallMethod ( ) no puede cambiar el valor del parámetro de entrada del ele¬ 
mento que hace la llamada. Sólo puede cambiar el valor de su copia del valor. 

Parámetros de salida 

Los parámetros de salida son parámetros cuyos valores no se establecen cuando 
se llama al método. En su lugar, el método establece los valores y los dev uelve al 
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elemento que hace la llamada mediante el parámetro de salida. Suponga, por 
ejemplo, que quiere escribir un método que cuente el número de registros de una 
tabla de una base de datos. Suponga que también quiere especificar si la opera¬ 
ción se realizó satisfactoriamente. (La operación puede no realizarse si. por ejem¬ 
plo. la tabla de bases de datos no está disponible.) Por tanto, queremos que el 
método devuelva dos instancias de información: 

• Un contador de registros. 

• Un indicador de éxito de operación. 


c y C:\WINDOWS\System32\cmd.eHe 

C: \ > L it i ri q (> S . e x e 

G 

3 

C:\>_ 



.jnjxj 


Id 


Figura 6.4. Demostración de parámetros de entrada con la función caliMethod (). 


C# sólo permite a los métodos devolver un valor. ¿Qué hacer si queremos que 
devuelva dos instancias de información 9 

La respuesta está en el concepto de parámetro de salida. Puede hacer que su 
método devuelva el indicador de éxito de la operación como un valor booleano y 
especificar el recuento de registros como un parámetro de salida. El método alma¬ 
cena el recuento de registros en una variable de salida, cuyo valor es recogido por 
el elemento que hizo la llamada. 

Los parámetros de salida se especifican en listas de parámetros con la palabra 
clave out . La palabra clave out debe preceder al tipo de parametro en la lista de 
parámetros. Cuando se llama a un método con un parámetro de salida, se debe 
declarar una variable que contenga ese valor, como se ve en el listado 6.6. 

Listado 6.6. Cómo trabajar con parámetros de salida 


class Listing6__6 
{ 

public static void Main() 
{ 

int Mylnteger; 
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Listing6_6 MyObject; 


MyObject = new Listing6_6(); 

MyObject.CallMethod ( out MyTnteger) ; 

System.Consolé.WriteLine(Mylnteger); 

} 

void CallMethod(out int Integerl) 
í 

Integerl - 7; 

} 

} 

El listado 6.6 define un método llamado CallMethod {) . que define un 
parámetro de salida entero llamado Integerl. El cuerpo de! método establece 
el valor del parámetro de salida en 7. El método Main() declara un entero 
llamado MyTnteger y lo usa como parámetro de salida para el método 
CallMethod ( ) . Cuando CallMethod () se devuelve, el valor de 
Mylnteger se escribe en la consola. La figura 6.5 contiene el resultado de 
estas aplicaciones de prueba de parámetros. 



Figura 6.5. Un parámetro de salida devuelve el valor apropiado 


Debe usarse la palabra clave out dos veces por cada parámetro: una vez 
cuando se declara el parametro y otra vez cuando se especifica el parámetro de 
salida al llamar al método. Si se olvida la palabra clave out al llamar a un 
método con un parámetro de salida, se obtienen los siguientes errores del compilador: 

Listing6-6.cs (9,6): error CS 1502: La mejor coincidencia de 
método sobrecargado para 'List ing6__6 . Cal lMethod ( out int)' tiene 
algunos argumentos no validos 

Listing6-6.cs (9,26) : error CS 1503: Argumento '1': no se puede 
convertir de 'int' a 'out int' 








Cualquier valor asignado a variables usadas como parámetros de salida antes 
de que se llame al método se pierde. Los valores originales se sobrescriben con los 
valores que les asignó el método. 

Parámetros de referencia 

Los pa reúne tros de referencia proporcionan valores por referencia. En otras 
palabras, el método recibe una referencia a la variable especificada cuando se 
llama al método. Piense en un parámetro de referencia como en una variable de 
entrada y de salida: El método puede leer el valor original de la variable y también 
modificar el valor original como si fuera un parámetro de salida. 

Los parámetros de referencia se especifican en listas de parámetros con la 
palabra clave ref . La palabra clave ref debe preceder al tipo del parámetro en 
la lista de parámetros. Cuando se llama a un método con un parámetro de referen¬ 
cia. se debe declarar una variable para que contenga el valor del parámetro de 
referencia, como se ve en el listado 6.7. 

Listado 6.7. Cómo trabajar con parámetros de referencia 

class Listing6_7 

{ 

public static void Main() 

í 

int Mylnteger; 

Listing6_7 MyObject; 

MyObject = new Listing6_7(); 

Mylnteger = 3; 

System. Consolé .WnteLine (Mylnteger) ; 

MyObject.CallMethod ( ref Mylnteger) ; 

System. Consolé .WnteLine (Mylnteger) ; 

} 


void CallMethod(ref int Integerl) 
{ 

Integerl = 4; 


} 

El método CallMethod ( ) del listado 6.7 usa un parámetro de referencia 
llamado Integerl. El cuerpo del método establece el valor del parámetro de 
referencia en 4. El método Main() declara una variable entera llamada 
Mylnteger y le asigna un valor de 3. Escribe el valor de Mylnteger en la 
consola y luego lo usa como el parámetro del método CallMethod ( ) Cuando 
CallMethod ( ) se devuelve, el valor de Mylnteger se escribe en la consola 
una segunda vez. Si ejecuta el código del listado 6.7 debería obtener los valores 
que aparecen en la figura 6.6. 
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c \ C:\WIND0WS\System32\cmd.exe 


C:\>Listing6 7.exe 

3 

4 

C:\>_ 


Figura 6.6. Un parámetro de referencia cambia su variable directamente. 

La segunda línea lee 4 porque la sintaxis del parámetro de referencia permite 
al método cambiar el valor de la variable original. Éste es un cambio respecto al 
ejemplo de parámetro de entrada del listado 6.5. 

Debe usarse la palabra clave ref dos veces para cada parámetro: una vez 
cuando se declara el parámetro en la lista de parámetros y otra vez cuando se 
especifica el parámetro de referencia al llamar al método. 

Matrices de parámetros 

Los métodos suelen escribirse para recibir un numero específico de parámetros. 
Un método con una lista de tres parámetros siempre espera ser llamada con tres 
parámetros, ni más. ni menos. Sin embargo, a veces puede ocurrir que un método 
no conozca cuántos parámetros debe aceptar al ser diseñado. Puede escribir un 
método que acepte una lista de cadenas que especifiquen los nombres de los regis¬ 
tros que deberán borrarse del disco. ¿Cuántas cadenas debe permitir el método? 
Para ser flexible, el método debe diseñarse de manera que el invocador pueda 
especificar las cadenas que necesita. Esto hace que llamar al método sea un poco 
más flexible porque el elemento que realiza la llamada ahora puede decidir cuan¬ 
tas cadenas deben pasarse al método. Sin embargo ¿como escribiremos la lista 
de parámetros de la lista cuando el método no conoce cuántos parámetros le 
serán pasados^ 

Las matrices de parámetros resuelven este problema de diseño ya que permiten 
especificar que el método acepte un número variable de argumentos. La matriz de 
parámetros de la lista de parámetros se especifica usando la palabra clave de CU 
params. seguida del tipo de variable que deberá proporcionar el llamador La 
especificación de tipos va seguida de corchetes, que a su vez van seguidos del 
identificador de la matriz de parámetros, como se ve en el listado 6.8. 
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Listado 6.8. Cómo trabajar con matrices de parámetros 


class Listing6_8 
{ 

public static void Main() 

{ 

Listing6_8 MyObject; 

MyObject = new Listing6_8{); 
MyObject.CallMethod (1) ; 

MyObject.CallMethod(1, 2); 

MyObject.CallMethod(1 , 2 , 3); 

} 


void CallMethod(params int[] ParamArray) 

{ 

System.Consolé.WriteLine("- ")> 

System.Consolé.WriteLine("CallMethod()"); 

System. Consolé.WriteLine ( "-" ) ; 

foreach(int ParamArrayElement in ParamArray) 

System.Consolé.WriteLine(ParamAr rayElement) ; 



En el listado 6.8. el método CallMethod ( ) esta escrito para aceptar un 
número variable de enteros. El método recibe los parámetros en forma de matriz 
de números enteros. El cuerpo del método usa la instrucción foreach para 
iterar la matriz de parámetros y escribe cada elemento en la consola. 

El método Main ( ) llama al método CallMethod ( ) tres veces, cada vez 
con un número de argumentos diferente. Esto es posible sólo porque 
CallMethod ( ) se declara con una matriz de parámetros. La figura 6.7 indica 
que todos los parámetros fueron pasados intactos al método. 



Figura 6.7. La palabra clave params permite cualquier número de parámetros. 
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Puede usar una matriz de parámetros en su lista de parámetros de método. 
Puede combinar una matriz de parámetros con otros parámetros en la lista de 
parámetros de método. Sin embargo, si usa una matriz de parámetros en una lista 
de parámetros de método, debe especificarla como el último parámetro de la lista. 
No se puede usar las palabras clave out o ref en una matriz de parámetros. 


Sobrecarga de métodos 

C# permite definir varios métodos con el mismo nombre en la misma clase, 
siempre que esos métodos tengan listas de parámetros diferentes. Esta operación 
se conoce como sobrecargar el nombre del método. Observe el ejemplo en el 
listado 6.9. 


Listado 6.9. Cómo trabajar con métodos sobrecargados 

class Listing6_9 
{ 

public static void Main() 

{ 

Listmgc 9 MyObject; 

MyObject = new Listing6_9(); 

MyObject.Add(3, 4); 

MyObject.Add(3.5, 4.75); 

} 


void Add(int Integerl, int Integer2) 
{ 

int Sum; 


System.Consolé.WriteLine("adding two mtegers"); 
Sum = Integerl + Integer2; 

System.Consolé.WriteLine (Sum) ; 


void Add(double Doublel, double Double2) 
{ 

double Sum; 


System.Consolé.WriteLine{"adding two doubles"); 
Sum = Doublel + Double2; 

System.Consolé.WriteLine(Sum); 



El listado 6.9 implementa dos métodos Add ( ) . Uno de ellos toma dos núme¬ 
ros enteros como parámetros de entrada y el otro toma dos dobles. Como las dos 
implementaciones tienen diferentes listas de parámetros. C# permite que los dos 
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métodos Add ( ) coexistan en la misma clase. El método Main ( ) llama al méto¬ 
do Add ( ) dos veces: una vez con dos parámetros integrales y otra con dos valo¬ 
res de punto flotante. Como puede ver en la figura 6.8, los dos métodos se ejecutan 
satisfactoriamente, procesando los datos correctos. 



Figura 6.8. El método sobrecargado suma números enteros y dobles. 


Cuando el compilador de C# encuentra una llamada a un método que tiene 
más de una implementación. examina los parámetros usados en la llamada y lla¬ 
ma al método con la lista de parámetros que mejor concuerde con los parámetros 
usados en la llamada. En la primera llamada a Add ( ) se usan dos números 
enteros. Entonces, el compilador de C# empareja esta llamada con la 
implementación de Add ( ) que toma los dos parámetros de entrada enteros por¬ 
que los parámetros de la llamada concuerdan con la lista de parámetros que tiene 
los números enteros. En la segunda llamada a Add ( ) se usan dos dobles. El 
compilador de C# entonces empareja esta llamada con la implementación de 
Add ( ) que toma los dos parámetros de entrada dobles porque los parámetros de 
la llamada concuerdan con la lista de parámetros que tiene los dobles. No todos 
los métodos sobrecargados necesitan usar el mismo número de parámetros en su 
lista de parámetros, ni todos los parámetros de la lista de parámetros tienen que 
ser del mismo tipo. El único requisito que C# exige es que las funciones tengan 
diferentes listas de parámetros. Una versión de una función sobrecargada puede 
tener un entero en su lista de parámetros y la otra versión puede tener tipos de 
datos como string, long y character en su lista de parámetros. 

Métodos virtuales 

Para proseguir con el tema de los métodos virtuales, hay que comprender el 
concepto de herencia. La herencia basa una clase en otra ya existente, añadiendo 




o quitando funcionalidad según se necesite. En las siguientes secciones examina¬ 
remos cómo se crean y se usan los métodos virtuales. 

Métodos sobrecargados 

Para empezar esta sección, construirá un ejemplo de clase llamado Books. 
Esta clase contiene dos métodos llamados Tit le y Rating. El método Ti t le 
devuelve el nombre de un libro y el método Rating devuelve una cadena indi¬ 
cando el número de estrellas con que ha sido calificado el libro en cuestión. En el 
listado 6.10 se recoge el código completo de su aplicación. Escríbalo en su editor 
de texto preferido y compílelo como hizo antes. 

Listado 6.10. Cómo mostrar la información de! título y la puntuación de un libro 

con las siguientes clases 

using System; 

namespace BookOverride 
{ 

class Book 
{ 

public string Title() 

{ 

return "Programming Book"; 

} 

public string RatingO 
{ 

return "5 Stars"; 

} 

} 

class Class 1 
{ 

static void Main(string[] args) 

{ 

Book be = new Book(); 

Consolé .WriteLme (be.Title () ) ; 

Consolé.WriteLine(be.Rating() ) ; 



Antes de ejecutar este programa, repáselo rápidamente. Como puede obser¬ 
var. una clase contiene el método Main ( ) . Este método es donde se inicializa 
una instancia de la clase BookOverride. que contiene los métodos Title y 
Rating. 

Después de inicializar una instancia, se llama a los métodos Title y Rating 
v se escribe la salida en la consola. El resultado puede verse en la figura 6.9. 




c C:\WirHD0WS\System32\cmd.eHe 

THSHiíM 

B 

; • ■ ; ■ ' 
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Figura 6.9. El título y la puntuación de su libro aparecen como se esperaba. 

A continuación, sobrecargue el método Title creando una clase basada en 
la clase Book. Para crear una clase basada en otra clase (y que por tanto permi¬ 
te sobrecargar métodos), simplemente declare una clase de la forma habitual y 
ponga a continuación del nombre de la clase dos puntos y el nombre de la clase 
en la que quiere que se base. Añada el código del listado 6.11 a la aplicación. 

Listado 6.11. Cómo sobrecargar métodos derivando la clase Book 

class Wiley : Book 

{ 

new public string Title () 

í 

return "C# Bible"; 

} 

} 

Este código crea una clase Wiley que hereda la clase Book. Ahora puede 
para crear un nuevo método público llamado Title. Como ya se ha asignado a 
este método el mismo nombre que al definido en la clase Book, se sobrecarga el 
método Title aunque sigue disponiendo de acceso a los otros miembros dentro 
de la clase Book. 


1 : ■;? : 

,■ - -I 
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Ahora que ha sobrecargado el método Title, debe cambiar el método 
Main () para usar su nueva clase. Cambie su método Main ( ) como se mues¬ 
tra en el listado 6.12. 










Listado 6.12. Cómo modificar el método Main() para sobrecargar una clase 


static void Main(string[] args) 

{ 

Wiley be = new Wiley(); 

Consolé.WriteLine(bc.Title()); 
Console.WnteLine (be. Rat ing ( ) ) ; 


En su método Main(). cambie la variable be para crear la nueva clase Wiley. 
Como habrá adivinado, al llamar al método Title. el titulo del libro cambia de 
Programming Book a C# Bible. Fíjese en que todavía tiene acceso al 
método Rating. que fue definido originalmente en la clase Book. 

La sobrecarga de métodos dentro de una clase base es una excelente manera de 
cambiar la funcionalidad específica sin grandes problemas 


Resumen 


C# permite escribir métodos en sus clases de C#. Los métodos pueden ayudar 
a div idir el código en partes fáciles de entender y pueden brindar un lugar único en 
el que almacenar código que puede ser llamado varias veces. 

Las funciones pueden recibir parámetros. Los parámetros de entrada contie¬ 
nen valores que han sido pasados a los métodos, pero sus valores no pueden 
cambiar. Los parámetros de salida tienen valores que les son asignados por un 
método y el valor asignado es v isible para el elemento que hace la llamada. Los 
parámetros de referencia contienen valores que pueden ser proporcionados dentro 
de la función y además, su valor puede ser modificado por el método. Las matri¬ 
ces de parámetros permiten escribir métodos que toman un número variable de 
argumentos. 

C# también permite sobrecargar métodos. Los métodos sobrecargados tienen 
el mismo nombre pero diferentes listas de parámetros. C# usa los parámetros 
proporcionados en una llamada para determinar qué método debe invocar cuando 
se ejecute el código. 


166 








Agrupación 
de datos 
usando 
estructuras 


C# permite agrupar las variables en estructuras. Al definir una estructura 
para los datos, todo el grupo puede ser procesado con un solo nombre de estruc¬ 
tura, sin importar el número de variables que contenga la estructura. El uso de 
una sola estructura facilita la manipulación de un conjunto de variables, en lugar 
de tener que seguir la pista de cada variable por separado. Una estructura puede 
contener campos, métodos, constantes, constructores, propiedades, indizadores, 
operadores y otras estructuras. 

Las estructuras de C# son tipos de valor, no tipos de referencia. Esto significa 
que las variables de estructura contienen directamente los valores de las estructu¬ 
ras, en lugar de mantener una referencia a una estructura que se encuentra en otra 
parte de la memoria. 

Algunas de las variables declaradas en el código C# pueden tener una relación 
lógica con otras variables ya declaradas. Suponga, por ejemplo, que quiere escri¬ 
bir un código que trabaje con un punto de la pantalla. Puede declarar dos varia¬ 
bles para describir el punto: 

int XCoordinateOfPoint; 

int YCoordinateOfPoint; 

El punto tiene dos valores, la coordenada x y la coordenada y, que funcionan 
juntas para describir el punto. 
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Aunque puede escribir el código C# de esta manera, es bastante pesado. Los 
dos valores deben poder usarse en cualquier código que quiera trabajar con el 
punto. Si quiere que un método trabaje con el punto, tendrá que pasar los valores 
uno a uno: 

void Woi kWi t hPoint ( int /.Coordínate, int /Coordínate) ; 

void SetNewPomt (out int /Coordínate, out int /Coordínate); 

La situación resulta incluso más complicada cuando varias variables trabajan 
juntas para describir una sola entidad. Por ejemplo, un empleado en una base de 
datos de recursos humanos puede tener variables que representen un nombre de 
pila, un apellido, una dirección, un numero de teléfono y un salario actual. Contro¬ 
lar todas estas variables por separado y asegurarse de que todas se usan como 
un grupo puede volverse complicado. 

Cómo declarar una estructura 

Los contenidos de una estructura se declaran usando la palabra clave struct. 
Para dar nombre a una estructura use un identificado!* después de la palabra clave 
struct. La lista de variables que forman la estructura se encierra entre llaves a 
continuación del identificado!* de la estructura. Las declaraciones de miembro de 
la estructura suelen llevar antepuesta la palabra clave public para avisar al 
compilador de que sus v alores deben ser públicamente accesibles a todo el codigo 
de la clase. Cada declaración de miembro termina con un punto v coma. La 
declaración de una estructura que defina un punto puede parecerse a lo siguiente: 

struct Point 

{ 

public int X; 
public int Z; 

} 

En el ejemplo anterior, los miembros de la estructura. X e Y. tienen el mismo 
tipo. Sin embargo, esto no es obligatorio. Las estructuras también pueden estar 
formadas por variables de distintos tipos. El ejemplo anterior del empleado puede 
presentar este aspecto: 

struct Employee 

{ 

public string FirstName; 
public string LastName; 
public string Address; 
public string City; 
public string State; 
public ushort ZIPCode; 
public decimal Salary; 

} 




Como con todas las instrucciones de C#. sólo puede declararse una estructura 
desde el interior de una clase. 



Los valores iniciales de los miembros de la estructura siguen las reglas de 
inicialización de valores descritas en un capítulo anterior Los valores se inicializan 
con alguna representación del cero y las cadenas se vacían. C# no permite inicializar 
miembros de estructuras en el momento de declararse. Observe el error en el 
siguiente código: 

struct Point 
{ 

public int X = 100; 
public int Y = 200; 

} 

Esta declaración produce estos errores del compilador: 

error CS0573: 'Point. X': no se permiten inicializadores de 
campo de instancia en las estructuras 

error CS0573: 'Point.Y' : no se permiten inicializadores de 
campo de instancia en las estructuras 

Puede usar un método especial llamado constructor para inicializar miembros 
de estructuras con valores distintos de cero. Más adelante, en este mismo capítu¬ 
lo, se examinarán los constructores. 

Cómo usar estructuras en el código 


Después de haber definido la estructura, puede usar su identificador como un 
tipo de variable, igual que si fuera un tipo int o long. Indique el identificador 
de la estructura, seguido de algún espacio en blanco y del identificador de la 
variable de estructura: 

Point MyPoint; 

Esta declaración declara una variable llamada MyPoint cuyo tipo es el de la 
estructura Point. Se puede usar esta variable igual que cualquier otra variable, 
incluso dentro de expresiones y como parámetro de un método. 

El acceso a cada miembro de la estructura resulta tan sencillo como escribir el 
nombre del identifícador de la variable de la estructura, un punto y a continuación 
el miembro de la estructura. El listado 7.1 muestra cómo se puede usar una es¬ 
tructura en el código. 
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Listado 7.1. Acceso a miembros de la estructura 


class Listing7 1 

{ 

struct Point 

{ 

public int X; 
public int Y; 

} 


public static void Main() 


Point MyPoint; 

MyPoint.X = 10 0; 

MyPoint.Y - 2 00 ; 

System.Consolé.WriteLine(MyPoint.X); 
System.Consolé.WriteLine(MyPoint.Y); 


} 

El resultado de este ejemplo debería ser el siguiente: 

100 
2 00 

Se puede asignar una variable de estructura a otra, siempre que las estructuras 
sean del mismo tipo. Cuando se asigna una variable de estructura a otra. C# 
asigna el valor de la variable de estructura que aparece antes del signo igual a los 
valores correspondientes de la estructura que aparece después del signo igual, 
como se puede observar en el listado 7.2. 

Listado 7.2. Asignación de una variable de estructura a otra 

class Listing7_2 

{ 

struct Point 

{ 

public int X; 
public int Y; 

} 


public static void Main() 

{ 

Point MyFirstPoint; 
Point MySecondPoint; 

MyFirstPoint.X = 100; 

MyFirstPoint.Y = 100; 

MySecondPoint.X = 200; 
MySecondPoint.Y = 200; 
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System.Consolé.WriteLine(MyFirstPoint.X); 
System.Consolé.WriteLine(MyFirstPoint.Y); 

MyFirstPoint = MySecondPoint; 

System.Consolé.WriteLine(MyFirstPoint. X) ; 
System.Consolé.WriteLine(MyFirstPoint.Y); 


} 

El código anterior asigna el valor 100 a los miembros de MyFirstPoint y 
el valor de 200 a los miembros de MySecondPoint. Los valores de 
MyFirstPoint se escriben en la consola y luego los valores de la variable 
MyFirstPoint se copian en los valores de la variable MySecondPoint. 
Tras la asignación, los valores de MyFirstPoint se vuelven a escribir en la 
consola. 

Si compila v ejecuta este código, obtendrá el resultado ilustrado en la figura 
7.1. 


ca C:\WINPQWS\System32\cmd.exe 

C : \ >b is t in cj7 2 . f xh 

\m 
im 
?.m 
2 m 


íf i.. 






Figura 7,1. Asignación de una estructura a otra 

Todos los valores de una estructura se sobrescriben en una asignación con los 
valores de la variable de estructura indicada después del signo igual. 


Cómo definir métodos en estructuras 


Además de variables, en las estructuras se pueden incluir métodos. Si necesita 
escribir un código que trabaje con los contenidos de una estructura, podría consi¬ 
derar la opción de escribir el método dentro de la misma estructura. 
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Cómo usar métodos constructores 


Una estructura puede incluir un método especial llamado constructor. Un 
método constructor se ejecuta cuando se ejecuta en tiempo de ejecución una 
declaración de variable que usa el tipo de la estructura. 

Las estructuras pueden tener varios constructores o ninguno. Las declaracio¬ 
nes de constructores de estructura son muy parecidas a las declaraciones de 
métodos de clase, con las siguientes excepciones: 

• Los constructores no devuelven ningún valor. No se pueden usar palabras 
clave de tipo de devolución para escribir un constructor de estructura, ni 
siquiera void. 

• Los identificadores de constructores tienen el mismo nombre que la estruc¬ 
tura 

• Los constructores deben tener al menos un parametro. C# no permite defi¬ 
nir un constructor sin parámetros. C# siempre define una constructor por 
defecto sin parámetros por nosotros. Éste es el constructor que imcializa 
todos los miembros de la estructura a cero o su equivalente. 

Una estructura puede definir más de un constructor, siempre que los construc¬ 
tores tengan diferentes listas de parámetros. El listado 7.3 muestra una estructura 
Point con dos constructores. 

Listado 7.3. Constructores de estructuras 

class Listing7_3 
{ 

struct Point 
{ 

public int X; 
public int Y; 

public Point(int InitialX) 

{ 

X = InitialX; 

Y = 1000; 

} 

public Point(int InitialX, int InitialY) 

{ 

X - InitialX; 

Y = InitialY; 

} 

} 


public static void Main() 

{ 

Point MyFirstPoint = new Point(); 
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Point MySecondPoint = new Point(100); 

Point MyThirdPoint = new Point(250, 475); 

System.Consolé.WriteLine(MyFirstPoint.X); 
System.Consolé.WriteLine(MyFirstPoint.Y); 

System.Consolé.WriteLine(MySecondPoint.X); 
System.Consolé.WriteLine(MySecondPoint.Y); 

System.Consolé.WriteLine (MyT hirdPoint.X) ; 
System.Consolé.WriteLine(MyThirdPoint.Y)I 



La figura 7.2 ilustra el resultado de compilar y ejecutar el código del listado 

7.3. 


C V C:\WIfSDQWS\5ystem32\cmd.exe 

:\>Listing?~3.exe 

100 

1000 

250 

475 


Figura 7.2. La estructura revela los valores predefinidos. 

Tenga en cuenta los siguientes conceptos del listado 7.3: 

• La estructura Point declara dos constructores. Uno recibe como argu¬ 
mento un solo número entero y el otro recibe dos números enteros. Ambos 
llevan antepuesta la palabra clave public por lo que su código es accesi¬ 
ble al resto del código de la clase. 

• El constructor con un parámetro entero asigna al miembro X de la estruc¬ 
tura el valor del argumento entero y asigna al miembro Y de la estructura 
el valor 1.000. 

• El constructor con dos parámetros enteros asigna al miembro X de la es¬ 
tructura el valor del primer argumento entero y asigna al miembro Y de la 
estructura el valor del segundo argumento entero. 
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• El código declara tres variables de tipo Point. Cada una de ellas llama a 
uno de los constructores Point. La declaración de MyFirstPoint 
llama al constructor sin argumentos. Este es el constructor por defecto que 
C# define para cada estructura. La declaración de MySecondPoint lla¬ 
ma al constructor que tiene un argumento y la declaración de 
MyThirdPoint llama al constructor con dos argumentos. 

Preste mucha atención a la sintaxis del listado 7.3. que invoca a un constructor 
de estructura. Si se quiere invocar a un constructor en una estructura, se debe 
emplear la palabra clave new seguida del nombre de la estructura y de los 
parametros del constructor entre paréntesis. El valor de esa expresión se asigna a 
la variable que se está declarando. Observe la siguiente declaración: 

Point MyThirdPoint = new Point (250, 475); 

Esta declaración indica: "Crea una nueva estructura Point usando el construc¬ 
tor que tiene dos enteros. Asigna su valor a la variable MyThirdPoint". Debi¬ 
do a las reglas de asignación de estructuras anteriormente descritas, los miembros 
de la variable MyThirdPoint reciben los valores de los miembros de la nueva 
estructura. No es necesario hacer nada más con la nueva estructura creada cuan¬ 
do se llamó a new. El entorno común de ejecución (CLR) detecta que la estruc¬ 
tura ya no se usa y se deshace de ella mediante el mecanismo de recolección de 
elementos no utilizados. 

En el listado 7.3 también aparece la sintaxis del constructor sin parámetros: 

Point MyFirstPoint = new Point(); 

Asi se indica al compilador de C# que se quiere inicializar la estructura de la 
forma habitual. Se deben asignar valores a todos los miembros de una estructura 
antes de usarla, bien invocando su constructor sin parámetros o asignando explí¬ 
citamente todos los campos de un valor. Observe el listado 7.4. 

Listado 7.4. Si se usa una estructura antes de inicializarla se producen errores 

de compilación 


class Listing7_4 
{ 

struct Point 
{ 

public int X; 
public int Y; 

} 

public static void Main() 

{ 

Point MyPoint; 

System.Consolé.WriteLine(MyPoint.X); 
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System.Consolé.WriteLine(MyPoint.Y); 

} 

} 

El código anterior es erróneo y al compilarlo el compilador de C# produce los 
siguientes mensajes de error: 

error CS0170: Uso del campo 'X', posiblemente 
error CS0170: Uso del campo 'Y', posiblemente 
warning CS0649: El campo ' Listing7_4.Point.X' 
siempre tendrá el valor predeterminado 0 
warning CS0649: El campo 'Listing7_4.Point.Y' 
siempre tendrá el valor predeterminado 0 

Los mensajes de error avisan de que las llamadas a WriteLine ( ) usan 
miembros de datos en la estructura, pero que a esos miembros de datos todavía 
no se les ha asignado valor. La variable MyPoint no ha sido inicializada con una 
llamada al constructor sin parámetros ni tampoco se han asignado valores explí¬ 
citamente a sus miembros. C# no invoca al constructor sin parámetros a menos 
que se escriba la llamada en el código. 

Éste es otro ejemplo de cómo el compilador de C# protege el código para evitar 
que se comporte de forma impredecible. Todas las variables deben inicializarse 
antes de ser usadas. 

Cómo llamar a métodos desde estructuras 

También se pueden escribir métodos en las estructuras. Estos métodos siguen 
las mismas reglas que los métodos de clase: deben especificar un tipo de devolu¬ 
ción (o void) y tener un identificador y una lista de argumentos, que puede estar 
vacia. Para llamar a un método en una estructura se usa la misma notación de 
puntos que para acceder a un método de clase. Observe el listado 7.5. 

Listado 7.5. Cómo llamar a métodos de estructura 

class Listing7__5 
{ 

struct Point 
{ 

public int X; 
public int Y; 

public Point(int InitialX, int InitialY) 

{ 

X = InitialX; 

Y = InitialY; 

} 

public bool IsAtOrigin() 

{ 


no asignado 
no asignado 
nunca se asigna y 

nunca se asigna y 




íf ( o: == ü) && (Y = = o) ) 

return true; 

Sise 

r e t u r n fdlse; 



pub1 1 c static voi d Mam ( ) 

{ 

Pomt MyFírstPomt = new Poi nt ( 1 00 , 2 0 0); 

Po in t My 2 ec;o nd Po i nt - new Po i nt ( ) ; 

i £ (MyFirstP o int.IsAt O rigin (| -- true) 

S ys t em . Cons oí e . Wr i t e Line ( "My Fi. r s t. Poi nt i s at the 
o r i g i n . " i ; 
e 1 í e 

d ys t em .<.lo nso I e . Wr i. t eL i ne ( ”MyFi. rstPo.i nt i s not a t t he 
o r i g i n . " i ; 


i t (MySecondPo i nt . IsAtOrigm ( ) == true) 

Sy.stem.Conso 1 e .Wr i teLine ( "MySecondPoint ís at the 
o r i g i. n . " j ; 
ei.se 

.System. Cons o 1 e .Wr i teLine ( "MySecondPo] nt i s not at the 
o r i g i n . " ) ; 

} 

} 


La estructura Poi nt del listado 7.5 declara un método llamado IsAtOri qi n. 
El código de ese método comprueba los valores de los métodos de la estructura y 
devuelve true si las coordenadas del punto son (0. 0) y f alse en cualquier otro 
caso. El método Main ( ) declara dos variables de tipo Point: a la variable 
MyFirstPoint se le asignan las coordenadas (100. 200) usando el constructor 
explícito y a la variable MySecondPoint se le asignan las coordenadas (0. 0) 
usando el constructor por defecto sin parámetros. En ese momento el método 
Main { ) llama al método IsAtOrigin con los dos puntos y escribe un mensaje 
basado en el valor devuelto por el método. Si se compila y ejecuta el codigo del 
listado 7.5. se obtiene el siguiente resultado en la consola: 

MyFirstPoint is not at the origin. 

MySecondPoint is at the origin. 

Elay que asegurarse de prefijar los métodos con la palabra clave public si se 
quiere que sean accesibles por todo el resto del código de la clase. 

Cómo definir propiedades en estructuras 

Las propiedades de una estructura permiten leer, escribir y calcular valores 
usando descriptores de acceso. A diferencia de los campos, las propiedades no se 
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consideran variables; por tanto, no designan espacios de almacenamiento Debi¬ 
do a esto, no pueden ser pasadas como parámetros ref o out. 

El listado 7.6 incluye una propiedad dentro de la estructura Point. 

Listado 7.6. Definición de una propiedad en el interior de una estructura 

class Listing7_6 
{ 

struct Point 

í 

private int x; 
public int X 
{ 

ge t 
{ 

return x; 

} 

set 

{ 

x = valué; 

} 

} 

} 


public static void Main() 

{ 

int RetValue; 

Point MyPoint = new Point(); 

MyPoint.X = 10; 

RetValue = MyPoint.X; 

System.Console.WriteLine(RetValue); 



Este código asigna un valor al miembro X de la estructura Point y luego 
devuelve este valor a la variable RetValue. El resultado del listado 7.6 se 
ilustra en la figura 7.3. 

El uso de propiedades es una forma excelente de leer, escribir y calcular datos 
dentro de una estructura. No hace falta incluir métodos voluminosos para que 
realicen los cálculos y se puede definir cómo y cuándo pueden actuar los 
descriptores de acceso get y set. 

Cómo definir indizadores en estructuras 

Los indizadores son objetos que permiten indizar una estructura de forma muy 
parecida a una matriz. Con un mdizador. se pueden declarar varias estructuras al 
mismo tiempo y hacer referencia a cada estructura usando un número de índice. 
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El listado 7.7, que declara una estructura llamada MyStruct que contiene una 
cadena v un índice, lo demuestra. 



Figura 7.3. Definición de una propiedad en el interior de una estructura 


Listado 7.7. Cómo incluir un mdizador en una estructura 

c; 1 a s s Listín g 7 _7 

I 

struc t MyStruct 
i 

public string [jdata ; 
public string this [int índex] 

{ 

ge t 
{ 

return data[índex]; 

} 

set 

{ 

data[índex] = valué; 

} 

} 

} 

public static void Main() 

{ 

i n t x ; 

MyStruct ms = new MyStruct (); 
ms.data = new string[5]; 
ms [ 0 ] - "Brian D Patterson"; 

ms[1 ] = "Aimee J Patterson"; 

ms[2 ] = "Breanna C Mounts"; 

ms [3] = "Haileigh E Mounts"; 

ms [ 4 ] = "Brian W Patterson"; 









for (x=0;x<5;x++) 

System.Consolé.WriteLine(ms[x]); 


} 

} 

Como se puede ver, este ejemplo crea un nuevo objeto MyStruct y asigna a 
los miembros data el valor 5. lo que indica que se usan cinco copias de esta 
estructura. Para hacer referencia a cada copia de esta estructura se usa un número 
indizador (de 0 a 5) y se almacenan los nombres dentro de la estructura. Para 
asegurarse de que todos lo datos permanecen intactos, se aplica un simple bucle a 
los posibles números de índice y se escribe el resultado en la consola. 

En la figura 7.4 se ilustra el resultado del listado 7.7. 


ca C:\WINDOWS\5ystem32\cmd.eKe 


C: \ > L i > t i n q 7 7 . e <»: 
Br ian D Pat: t.e r ;on 
ÍHnee J Pat;tori;ou 
Bimí anna C Mounts 
Hai. Iftiqh f Motín ta; 
Br Luí U Pa t t e r on 



Ld 


Figura 7.4. Para devolver fácilmente los datos se incluye un indizador dentro 

de la estructura 


Un indizador en una estructura puede ser muy útil cuando se trabaja con gran¬ 
des cantidades de datos del mismo tipo. Por ejemplo, si se va a leer la información 
de una dirección desde una base de datos, éste es un excelente lugar para 
almacenarla. Todos los campos se mantienen mientras se proporciona un meca¬ 
nismo para acceder fácilmente a cada dato de los registros. 


Cómo definir interfaces en estructuras 

Las interfaces son un modo de asegurarse de que cualquiera que use la clase 
cumple con todas las reglas impuestas para hacerlo. Éstas pueden incluir la 
implementación de ciertos métodos, propiedades y eventos. Cuando se expone 
una interfaz, sus usuarios deben heredarla y al hacerlo están obligados a crear 
ciertos métodos y así sucesivamente. Esto asegura que la clase v/o estructura se 
use de forma correcta. 
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También se puede incluir una interfaz dentro de una estructura. El listado 7.8 
muestra cómo implementar correctamente una interfaz. 

Listado 7.8. Cómo implementar una interfaz en una estructura 

cíass Listing7_8 
{ 

interface IInterface 
{ 

void Method(); 

} 

struct MyStruct : IInterface 

í 

public void Method() 

{ 

System.Consolé.WriteLine("Structure Method”); 



public static void Main() 

{ 

MyStruct DemoStructure - new MyStruct(); 
DemoStructure.Method(); 

} 


Este código crea una interfaz llamada IInterface. Esta interfaz contiene 
la definición de un método llamado Method. Se crea una estructura y al final de 
su nombre se incluyen dos puntos seguidos del nombre de la interfaz que desea 
derivar. El método, que simplemente escribe una línea de texto en la consola, se 
incluye en la estructura. En la figura 7.5 es ilustra el resultado del programa. 

Para demostrar lo importante que es la interfaz, si elimine las cuatro líneas que 
componen el método Method en la estructura MyStruct y vuelve a compilar 
el programa, obtendrá el siguiente mensaje de error: 

Classi.es (8,9) : error CS0535: 'Listing7_8.MyStruct' no implementa el 

miembro de interfaz Listing7_8.IInterface.Method()' 

El compilador de C# determinó que no implementamos todos los métodos es- 
tipulados por la interfaz. Como no se implemento el método correcto, el programa 
no se pudo compilar, indicando de esta forma que no se cumplen todas las reglas. 

Cómo usar los tipos simples de C# como 
estructuras 

Los tipos primitivos (int. uint. long y similares) descritos en un capítulo 
anterior en realidad se implementan como estructuras en el CLR de NET La 
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tabla 7.1 enumera las palabras clave con valor variable y los nombres de las 
estructuras .NET que actualmente los implementan. 


xj 


Ld 

Figura 7.5. Cómo implementar un interfaz en una estructura 


Tabla 7.1. Nombres de estructura NET para tipos de valor 


Palabra clave de C# 

Nombre de estructura .NET 

sbyte 

System.SByte 

by t e 

System.Byte 

short 

System.Int16 

ushort 

System.Uint16 

int 

System.Int 3 2 

uint 

System.Uint32 

long 

System.Int64 

ulong 

System.Uint 64 

char 

S ys tem.Char 

f loa t 

System.Single 

double 

System.Double 

bool 

System.Boolean 

decimal 

System.Decimal 


Este esquema es parte de lo que hace que el código C# sea compatible con 
otros lenguajes NET. Los valores C# se asigna a las estructuras NET que pue- 


C:\WINDOWS\System32\cmd.exe 


C:\>Lis ting?H3.exe 
Struéture Method 


JJBJ 
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de usar cualquier lenguaje NET. porque el CLR puede usar cualquier estructura 
NET La asignación de las palabras claves de C# con estructuras NET también 
permite que las estructuras usen técnicas como la sobrecarga de operadores para 
definir el comportamiento del valor cuando se usan en una expresión con un opera¬ 
dor. Se analizará la sobrecarga de operadores cuando se traten las clases C#. 

Si lo desea, puede usar los nombres reales de estructura .NET en lugar de las 
palabras clave de C#. El listado 7.9 muestra el aspecto que tendría el listado 7.5 
si se escribiera usando los nombres de estructuras .NET. 

Listado 7.9. Cómo usar los nombres de tipo de estructura .NET 

class Listing7_9 

{ 

struct Point 

{ 

public System.Int32 X; 
public System.Int32 Y; 

public Point(System.Int32 InitialX, System.Int32 InitialY) 

{ 

X = InitialX; 

Y = InitialY; 

) 

public System.Boolean IsAtOrigin() 

{ 

if ( (X — — 0) && (Y == 0) ) 

return true; 
e ls e 

return false; 

} 

} 

public static void Main() 

{ 

Point MyFirstPoint = new Point (100, 200); 

Point MySecondPoint = new Point(); 

íf (MyFirstPoint.IsAtOrigin() = = true) 

System.Consolé.WriteLine("MyFirstPoint is at the origin."); 
e 1 s e 

System.Consolé.WriteLine("MyFirstPoint is not at the 
origin.") ; 

if(MySecondPoint.IsAtOrigin() == true) 

System.Consolé.WriteLine("MySecondPoint is at the 
origin.") ; 
e 1 s e 

System.Consolé.WriteLine("MySecondPoint is not at the 

origin.") ; 




Resumen 


Las estructuras permiten agrupar un conjunto de variables con un solo nom¬ 
bre. Las variables pueden declararse usando el identificador de estructura 

Las estructuras se declaran usando la palabra clave de C# struct. Todas las 
estructuras de C# tienen un nombre y una lista de miembros de datos. C# no pone 
ningún límite al número de miembros de datos que puede contener una estructura. 

Se accede a los miembros de estructuras mediante la notación StructName . 
MemberName. Los miembros se pueden usar en cualquier parte donde este per¬ 
mitido usar su tipo de datos, incluyendo expresiones y parámetros de métodos. 

Las estructuras pueden implementar tanto métodos como variables. Los miem¬ 
bros de estructuras se invocan usando la notación StructName . MethodName 
v se usan igual que los nombres de método de clase. Las estructuras también 
implementan métodos especiales llamados constructores, que inicializan la es¬ 
tructura con un estado conocido antes de usar la estructura. 

Los tipos de valor de C# son asignados a estructuras definidas por el CLR de 
NET Esto es lo que permite que otros códigos de NET usen los datos. Todas las 
variables son compatibles con CLR de NET porque las variables se definen 
usando estructuras compatibles con el CLR 
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Parte II 

Programación 
orientada a 
objetos con C# 
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Escribir 


código 
orientado 
a objetos 


Los lenguajes de programación siempre se han diseñado en torno a dos con¬ 
ceptos fundamentales: los datos y el código que opera sobre los datos. Los len¬ 
guajes han evolucionado a lo largo del tiempo para cambiar el modo en que estos 
dos conceptos interactúan. En un principio, lenguajes como Pascal y C invitaban 
a los programadores a escribir software que tratara al código y a los datos como 
dos cosas separadas, sin ninguna relación. Este enfoque dio a los programadores 
la libertad, pero también la obligación, de elegir el modo en que su código gestio¬ 
na los datos. 

Además, este enfoque obligaba al programador a traducir el mundo real que se 
quería modelar usando software a un modelo especifico para ordenadores que 
usara datos y código. 

Los lenguajes como Pascal y C se construyeron en torno al concepto de proce¬ 
dimiento. Un procedimiento es un bloque de código con nombre, exactamente 
igual que los actuales métodos de C#. El estilo de software desarrollado usando 
estos lenguajes se llama programación procedural. 

En la programación procedural. el programador escribe uno o más procedi¬ 
mientos y trabaja con un conjunto de variables independientes definidas en el 
programa. Todos los procedimientos pueden verse desde cualquier parte del códi¬ 
go de la aplicación y todas las variables pueden ser manipuladas desde cualquier 
parte del código. 
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En los años 90. la programación proccdural dio paso a lenguajes como Smalltalk 
v Simula, que introdujeron el concepto de objeto. Los inventores de estos lengua¬ 
jes se dieron cuenta de que el ser humano no expresa ideas en términos de bloques 
de código que actúan sobre un grupo de variables; en su lugar, expresan ideas en 
términos de objetos Los objetos son entidades que tienen un conjunto de valores 
definidos (el estado del objeto) y un conjunto de operaciones que pueden ejecutar¬ 
se sobre ese objeto (los comportamientos del objeto). Por ejemplo, imagine un 
cohete espacial 

Un cohete espacial tiene estados, como la cantidad de combustible o el número 
de pasajeros a bordo, y comportamientos, como "despegar" y "aterrizar". Además, 
los obietos pertenecen a clases. Los objetos de la misma clase tienen el mismo 
estado v el mismo conjunto de comportamientos. Un objeto es un caso concreto de 
una clase. El cohete espacial es una clase, mientras que el cohete espacial llamado 
Discovcry es un objeto, un caso concreto de la clase cohete espacial. 


NOTA: En realidad, ni siquiera en la programación procedural son visibles 
todos los procedimientos ni todas las variables. Igual que en C#, los len¬ 
guajes procedurales tienen reglas de ámbito que controlan la visibilidad 
del código y de los datos. Por lo general podemos hacer visibles los proce¬ 
dimientos y los datos (a los que nos referiremos en este capítulo como 
elementos) en el procedimiento, archivo fuente, aplicación o nivel externo. 
El nombre de cada ámbito es autoexplicativo. Un elemento visible en el 
nivel de procedimiento sólo es accesible dentro del procedimiento en el que 
se define. No todos los lenguajes permiten crear procedimientos dentro de 
otros procedimientos. Un elemento visible en el nivel de archivo fuente es 
visible dentro del archivo en el que se define el elemento. En el nivel de 
aplicación, el elemento es visible desde cualquier parte de código en la 
misma aplicación. En el nivel externo, el elemento es visible desde cual¬ 
quier parte de código en cualquier aplicación. 

El punto principal es que, en programación procedural, la interacción entre 
datos y código está controlada por los detalles de implementación, como el 
archivo fuente en el que se define una variable. Una vez que se decide hacer 
visible una variable fuera de sus propios procedimientos, no se obtiene 
ayuda para proteger el acceso a esa variable. En aplicaciones grandes con 
varios miles de variables, esta falta de protección suele acarrear fallos 
difíciles de encontrar. 


El desarrollo de software orientado a objetos tiene dos claras ventajas sobre el 
desarrollo de software procedural La primera ventaja es que se puede especificar 
lo que debe hacer el software y cómo lo hará usando un vocabulario familiar a los 
usuarios sin preparación técnica. El software se estructura usando objetos. Estos 
objetos pertenecen a clases con las que el usuario del mundo de los negocios, al 
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que está destinado, esta familiarizado. Por ejemplo, durante el diseño de soft¬ 
ware ATM. se usan clases como CuentaBancaria. Cliente. Presen¬ 
tación y similares. 

Esto reduce el trabajo necesario para traducir una situación del mundo real al 
modelo de software y facilita la comunicación con la gente ajena al software y 
que está interesada en el producto final. Este modo más sencillo de diseñar soft¬ 
ware ha conducido a la aparición de un estándar para describir el diseño del 
software orientado a objetos. Este lenguaje es el Lenguaje unificado de modelado 
o UML. 

La segunda ventaja del software orientado a objetos se demuestra durante la 
implcmentación. El hecho de que ahora podemos tener ámbitos de nivel de clases, 
permite ocultar variables en las definiciones de clase. Cada objeto tendrá su pro¬ 
pio conjunto de variables y estas variables por lo general solamente serán accesi¬ 
bles mediante las operaciones definidas por la clase. Por ejemplo, las variables 
que contienen un estado del objeto CuentaBancaria sólo serán accesibles 
llamando a la operación Retirada ( ) o Depósito ( ) asociada a ese objeto. 
Un objeto CuentaBancaria (o cualquier otro objeto) no tiene acceso a otro 
estado privado del objeto CuentaBancaria. como el balance. A este princi¬ 
pio se le llama encapsalación. 

El desarrollo de software orientado a objetos se fue haciendo más popular a 
medida que los programadores adoptaban este nuevo modo de diseñar software. 
C# es un lenguaje orientado a objetos y su diseño garantiza que los programado- 
res de C# sigan los conceptos correctos de la programación orientada a objetos. 


NOTA: SmallTalk, Java y C# son lenguajes orientados a objetos puros 
porque no se puede escribir un programa sin usar objetos. A otros lengua¬ 
jes, como C y Pascal, se les llama lenguajes proc€«Íurales o no orientados a 
objetos porque no disponen de compatibilidad integrada que permita crear 
objetos. Existe un tercer tipo de lenguaje híbridos, como C+h% en los que se 
puede elegir si usar o no objetos. Bjame Stroustrup, el inventor 4 
decidió no obligar a loá Programador_ 

patibilidad con el código C existente ay 
un lenguaje importante. 


^ corn¬ 
ac ccmyirtiera en 


En este capitulo se estudian los conceptos que componen un lenguaje orientado 
a objetos, empezando por sus componentes esenciales (las clases y objetos), hasta 
los términos más avanzados (abstracción, tipos de datos abstractos, encapsulación. 
herencia y polimorfismo). 

Se tratarán los conceptos básicos y se procurará evitar los detalles específicos 
sobre cómo están implementados estos conceptos en C#. Estos detalles específi¬ 
cos se tratarán en capítulos posteriores. 
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Clases y objetos 

En primer lugar, esta sección vuelve a tratar la diferencia entre un objeto y una 
clase. Este libro usa mucho estos dos términos y es importante distinguir entre 
ellos. Una dase es una colección de codigo y de variables. Las clases gestionan el 
estado, en forma de las variables que contienen, y comportamientos, en forma de 
los métodos que contienen. Sin embargo, una clase sólo es una plantilla. Nunca se 
crea una clase en el código. En su lugar, se crean objetos. Por ejemplo. 
CuentaBancaria es una clase con una variable que contiene el saldo de la 
cuenta y los métodos Retirada ( ). Depósito ( ) y MostrarSaldo ( ) . 

Los objetas son casos concretos de una clase. Los objetos se constriñen 
usando una clase como plantilla. Cuando se crea un objeto, éste gestiona su pro¬ 
pio estado El estado de un objeto puede ser diferente del estado de otro objeto de 
la misma clase. Imagine una clase que define a una persona. Una clase persona 
va a tener estado (quizas, una cadena que representa el nombre propio de la 
persona) y comportamiento, mediante métodos como IrATrabajar ( ) . Co¬ 
mer ( ) e IrADormir (). Se pueden crear dos objetos de la clase persona, 
cada uno con un estado diferente, como se muestra en la figura 8.1. La figura 8.1 
muestra la clase persona y dos objetos persona: uno con el nombre propio "Alice" 
y otro con el nombre propio "Bob". El estado de cada objeto se almacena en un 
conjunto de variables diferentes. Vuelva a leer la frase anterior. Esta frase con¬ 
tiene un punto esencial para comprender el funcionamiento de la programación 
orientada a objetos. Un lenguaje admite objetos cuando no se necesita crear un 
código especial para disponer de un conjunto de variables cada vez que se crea 
un objeto diferente. 


NOTA: Si un lenguaje admite la gestión automática del estado dentro de 
objetos pero carece de las otras características descritas en esta sección, 
suele recibir el nombre de lenguaje basado en objetos. Visual Basic 6 admi¬ 
te objetos, pero no admite la herencia de implementación; por tanto, no se le 
considerar como un auténtico lenguaje orientado a objetos. Auténticos len¬ 
guajes orientados a objetos son SmallTalk, Java y C#. 


Terminología del diseño de software 
orientado a objetos 


Se encontrará con muchos términos cuando lea libros sobre el desarrollo de 
software orientado a objetos y probablemente se encuentre con muchos de estos 
términos cuando trabaje con codigo C#. Algunos de los términos más usados son: 
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• Abstracción 

• Tipos de datos abstractos 

• Encapsulación 

• Herencia 

• Polimorfismo 

Las siguientes secciones definen cada uno de estos términos con detalle. 


Person 

+FirstName : String 

+GoToWork(): void 
+Eat() : void 
+GoToSleep() : void 


Person 1 : Person 


Person2 : Person 

FirstName : String = Alice 


FirstName : String = Bob 


Figura 8.1. Esta clase persona tiene dos objetos persona. 


Abstracción 

Es importante darse cuenta de que el objetivo de la programación no es repro¬ 
ducir todos los aspectos posibles del mundo real de un concepto dado. Por ejem¬ 
plo. cuando se programa una clase Person. no se intenta modelar todo lo que se 
conoce sobre una persona. En su lugar, se trabaja dentro del contexto de la aplica¬ 
ción específica. Sólo se modelan los elementos que son necesarios para esa apli¬ 
cación Algunas características de una persona, como la nacionalidad, pueden 
existir en el mundo real, pero se omiten si no son necesarias para la aplicación en 
cuestión. Una persona en una aplicación bancaria estará interesada en aspectos 
diferentes de los de. por ejemplo, una persona en un juego de acción. Este concep¬ 
to recibe el nombre de abstracción y es una técnica necesaria para el manejo de 
los conceptos infinitamente complejos del mundo real Por tanto, cuando se haga 
preguntas sobre objetos y clases, tenga siempre en cuenta que debe hacerse estas 
preguntas en el contexto de una aplicación específica. 

Tipos de datos abstractos 

Los tipos de datos abstractos fueron el primer intento de determinar el modo 
en que se usan los datos en programación. Los tipos de datos abstractos se crea¬ 
ron porque en el mundo real los datos no se componen de un conjunto de varia- 
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bles independientes. El mundo real está compuesto de conjuntos de datos relacio¬ 
nados. El estado de una persona para una aplicación determinada puede consistir 
en. por ejemplo, nombre, apellidos y edad. Cuando se quiere crear una persona 
en un programa, lo que se quiere crear es un conjunto de estas variables. Un tipo 
de datos abstractos permite presentar tres variables (dos cadenas y un numero 
entero) como una unidad y trabajar cómodamente con esta unidad para contener 
el estado de una persona, como se ve en este ejemplo: 

struct Person 

{ 

public String FirstName; 
public String LastÑame; 
public int Age; 

} 

Cuando se asigna un tipo de datos a una variable del código, se puede usar un 
tipo de datos primitivo o un tipo de datos abstracto. Los tipos de datos primitivos 
son tipos que C# reconoce en cuanto se ínstala. Tipos como int. long. char y 
string son tipos de datos primitivos de CU. 

Los tipos de datos abstractos son tipos que CU no admite cuando se instalan 
Antes de poder usar un tipo de datos abstracto hay que declararlo en el código 
Los tipos de datos abstractos se definen en el codigo en lugar de hacerlo en el 
compilador de CU. 

Por ejemplo, imagine la estructura (o clase) Person. Si escribe código C# 
que usa una estructura (o clase) Person sin escribir código que le indique al 
compilador de C# a qué se parece una estructura (o clase) Person y cómo se 
comporta, se obtiene un error de compilación. Observe el siguiente código: 

class MyClass 

{ 

static voicl Main () 

{ 

Person MyPerson; 

Person.FirstName = "Malgoska"; 

} 

} 


Si se compila este código el compilador de C# genera el siguiente error. 

error CS0234: El tipo o el nombre del espacio de nombres 
'Person' no existe en la clase o el espacio de nombres 
'MyClass ' (¿falta una referencia de ensamblado?) 

El problema de este código es que el tipo de datos Person no es un tipo de 
datos primitivo y no está definido por el lenguaje C#. Como no es un tipo primi¬ 
tivo. el compilador de CU considera que se trata de un tipo de datos abstracto y 
revisa el código buscando la declaración de un tipo de datos Person. Sin embar¬ 
go. como el compilador de C# no puede encontrar información sobre el tipo de 


194 



datos abstracto Person genera un error. Tras definir un tipo de datos abstracto, 
puede usarse en el código C U exactamente igual que si fuera un tipo de datos 
primitivo. Las estructuras y las clases de C# son ejemplos de tipos de datos 
abstractos. Una vez que se ha definido una estructura (o clase), se pueden usar las 
variables de ese tipo dentro de otra estructura (o clase). La estructura 
LearningUnit. por ejemplo, contiene dos variables Person: 

struct LearningUnit 

{ 

public Person Tutor; 
public Person Student; 

} 

Encapsulación 

Mediante la encapsulación. los datos se ocultan, o se encapsulan . dentro de 
una clase y la clase implementa un diseño que permite que otras partes del código 
accedan a esos datos de forma eficiente. Imagine la encapsulación como un envol¬ 
torio protector que rodea a los datos de las clases de CU. 

Como ejemplo de encapsulación. observe la estructura Point con la que 
trabajó en un capítulo anterior. 

struct Point 

{ 

public int X; 
public int Y; 

} 


Los miembros de datos de esta estructura son públicos, lo que permite que 
cualquier parte de código que acceda a la estructura acceda también a los miem¬ 
bros de datos. Como cualquier parte de código puede acceder a los miembros de 
datos, el código puede asignar a los valores de los miembros de datos cualquier 
valor que pueda representarse en un valor int. 

No obstante, puede surgir un problema al permitir que los clientes asignen los 
valores de los miembros de datos directamente. Supongamos que se usa la estruc¬ 
tura Point para representar una pantalla de ordenador con una resolución de 
800 \ 600. En ese caso, sólo tiene sentido permitir al codigo que asigne a X 
valores entre 0 y 800 ya Y valores entre 0 y 600. No obstante, con el acceso 
público a los miembros de datos, no hay nada que impida al código asignar a X el 
valor 32.000 y a Y el valor 38.000. El compilador de CU lo permite porque esos 
valores son posibles en un entero. El problema es que no tiene sentido permitir 
valores tan elevados. 

La encapsulación resuelve este problema. Básicamente, la solución está en 
marcar los miembros de datos como privados, para que el código no pueda acce¬ 
der a los miembros de datos directamente. A continuación puede escribir métodos 
en una clase de punto como SetX () y SetY ( ) . Los métodos SetX () y SetY ( ) 
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pueden asignar los valores y también pueden contener código que genere un 
error si se trata de llamar a SetX ( ) o a SetY ( ) con parámetros con valores 
demasiado grandes. La figura 8.2 muestra el posible aspecto de una clase Point. 


Point 

-X : int 


-Y : int 


+SetX(): 

bool 

+SetY() : 

bool 

+GetX() : 

int 

+GetY(): 

int 


Figura 8.2. Las variables de miembros en la clase Point están encapsuladas 


NOTA: El signo menos delante de los miembros de datos es una notación 
UML que indica que los miembros tienen una visibilidad privada. El signo 
más delante dfe los miembros de datos es una notación UML que indica que 
los miembros tienen una visibilidad pública. 


La técnica consistente en marcar como privados los miembros de datos resuel¬ 
ve el problema de que el código establezca sus valores directamente. Si los miem¬ 
bros de datos son privados, sólo la propia clase puede verlos y cualquier otro 
código que intente acceder a los miembros de datos genera un error del compilador. 

En lugar de acceder directamente a los miembros de datos, la clase declara 
métodos públicos llamados SetX ( ) y SetY ( ) . El código que quiere asignar los 
valores de los puntos X e Y llama a estos métodos públicos. Estos métodos pue¬ 
den aceptar el nuevo valor de las coordenadas y un parametro, pero también 
pueden comprobar los nuevos valores para asegurarse de que están dentro de los 
límites adecuados. Si el nuevo valor está fuera de los límites, el método devuelve 
un error. Si el nuevo valor esta dentro de los límites, el método puede establecer 
un nuevo valor. El siguiente seudo código muestra cómo se puede implementar el 
método SetX ( ) : 

bool SetX (int NewXValue) 

í 

if(NewXValue ís out of range) 
return false; 

X = NewXValue; 
return true; 

} 


Este código ha encapsulado el miembro de datos de la coordenada X y permi¬ 
te a los invocadores asignar su valor a la vez que impide que le asignen un valor 
no válido. 

Cómo los valores de las coordenadas X e Y en este diseño son privados, las 
otras partes de código no pueden examinar sus valores actuales. La accesibilidad 
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privada en la programación orientada a objetos evita que las partes que realizan 
la llamada lean el valor actual o guarden el nuevo valor. Para exponer estas 
variables privadas, se pueden implementar métodos como GetX ( ) y GetY ( ) 
que devuelven el valor actual de las coordenadas. 

En este diseño, la clase encapsula los valores de X e Y aunque permite que 
otras partes del código lean y escriban sus valores. La encapsulación proporciona 
otra ventaja: el método que realiza el acceso impide que se asignen valores ab¬ 
surdos a los miembros de datos. 

Herencia 

Algunas clases, como la clase Point. se diseñan partiendo de cero. El esta¬ 
do y los comportamientos de la clase se definen en ella misma. Sin embargo, 
otras clases toman prestada su definición de otra clase. En lugar de escribir otra 
clase de nuevo, se pueden tomar el estado y los comportamientos de otra clase y 
usarlos como punto de partida para la nueva clase. A la acción de definir una 
clase usando otra clase como punto de partida se le llama herencia. 

Herencia simple 

Supongamos que estamos escribiendo código usando la clase Point y nos 
damos cuenta de que necesitamos trabajar con puntos tridimensionales en el mis¬ 
mo código. La clase Point que ya hemos definido modela un punto en dos 
dimensiones y no podemos usarlo para definir un punto tridimensional. Decidi¬ 
mos que hace falta escribir un punto tridimensional llamado Point3D. Se puede 
diseñar la clase de una de estas dos formas: 

• Se puede escribir la clase Point3D partiendo de cero, definiendo miem¬ 
bros de datos llamados X, Y y Z y escribiendo métodos que lean y escriban 
los miembros de datos. 

• Se puede derivar de la clase Point. que ya implementa los miembros X e 
Y. Heredar de la clase Point proporciona todo lo necesario para trabajar 
con los miembros X e Y. por lo que todo lo que hay que hacer en la clase 
Point3D es implementar el miembro Z La figura 8.3 muestra el aspecto 
que podría tener la clase Point3D en UML. 


NOTA: I-anotación UML indica que los miembros tienen visibilidad 


La figura 8.3 refleja la herencia simple. La herencia simple permite que una 
clase se derive de una sola clase base. Este tipo herencia también es conocido 
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como derivar una clase de otra. Parte del estado y del comportamiento de la 
clase Point3D se derivan de la clase Point. 

En este caso, la clase usada como punto de partida recibe el nombre de clase 
base y la nueva clase es la clase derivada. En la figura 8.3 la clase base es 
Point v la clase derivada es Point3D. 



Figura 8.3. La clase Pomt3D hereda los métodos y las variables de la clase Point. 

Derivar una clase de otra automáticamente permite que los miembros de datos 
públicos (v protegidos) y a los métodos públicos (y protegidos) de la clase base 
estén disponibles para la clase derivada. Como los métodos GetX ( ) . GetY ( ) . 
SetX ( ) y Set Y ( ) están marcados como públicos en la clase base, están 
automáticamente disponibles para las clases derivadas. Esto significa que la clase 
Po i n13D dispone de los métodos públicos GetX ( ) . GetY ( ) . SetX ( ) y 
Set Y ( ) ya que se derivaron de la clase base Point. Una sección de codigo 
puede crear un objeto de tipo Point 3D y llamar a los métodos GetX ( ) . GetY ( ) . 
SetX ( ) y SetY ( ) . aunque los métodos no esten implementados explícitamente 
en esa clase. Se derivaron de la clase base Point y pueden ser usados en la clase 
derivada Point3D. 

Herencia múltiple 

Algunos lenguajes orientados a objetos también permiten la herencias múlti¬ 
ple . lo que permite que una clase se derive de más de una clase base. C# solo 
permite herencias simples. 

Esta restricción se debe a que el CLR de NET no admite clases con varias 
clases base, principalmente porque otros lenguajes .NET. como Visual Basic, no 
admiten por sí mismos herencias múltiples. Los lenguajes que admiten herencia 
múltiple, como C++, también han evidenciado la dificultad de usar correctamente 
la herencia múltiple. 
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Polimorfismo 

La herencia permite que una clase derivada redefina el comportamiento espe¬ 
cificado para una clase base. Supongamos que creamos una clase base Animal. 
Hacemos esta clase base abstracta porque queremos codificar animales genéricos 
siempre que sea posible, pero también crear animales específicos, como un gato y 
un perro. El siguiente fragmento de código muestra cómo declarar la clase con su 
método abstracto. 

Abstract class Animal 
{ 

public abstract void MakeNoise() ; 

} 

Ahora se pueden derivar animales específicos, como Cat y Dog, a partir de la 
clase base abstracta Animal: 

class Cat : Animal 
{ 

public override void MakeNoise() 

{ 

Consolé.WriteLine("Meow!"); 

} 

} 


class Dog : Animal 
{ 

public override void MakeNoise() 

{ 

Consolé.WriteLine("Woof!"); 

} 

} 

Observe que cada clase tiene su propia implementación del método 
MakeNoise ( ) . Ahora la situación es la indicada para el polimorfismo. Como 
se aprecia en la figura 8.4. tenemos una clase base con un método que está anula- 
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do en dos (o más) clases derivadas. El polimorfismo es la capacidad que tiene un 
lenguaje orientado a objetos de llamar correctamente al método anulado en fun¬ 
ción de qué clase lo esté llamando. Esto suele producirse cuando se almacena una 
colección de objetos derivados. 

El siguiente fragmento de código crea una colección de animales, que recibe el 
apropiado nombre de zoo. A continuación añade un perro y dos gatos a este zoo. 

ArrayList Zoo; 

Zoo - new ArrayList(3) ; 

Cat Sasha, Koshka; 

Sasha = new Cat(); 

Koshka • new Cat(); 

Dog Milou; 

Milou - new Dog(); 



Figura 8.4. Este ejemplo de herencia muestra una clase base y dos clases derivadas. 

La colección zoo es una colección polimórfica porque todas sus clases derivan 
de la clase abstracta Animal. Ahora se puede iterar la colección y hacer que 
cada animal emita el sonido correcto: 

foreach (Animal a in Zoo) 

{ 

a.Ma keNoise () ; 

} 

Si ejecuta el codigo anterior producirá el siguiente resultado: 

Woof ! 

Me ow! 

Me ow ! 
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¿,Quc está pasando? Como C# permite el polimorfismo, en el tiempo de ejecu¬ 
ción el programa es lo suficientemente inteligente como para llamar a la versión 
perro de MakeNoise cuando se obtiene un perro del zoo y la versión gato de 
MakeNoise cuando se obtiene un gato del zoo. 

El listado 8.1 muestra el código C# completo que explica el polimorfismo. 

Listado 8.1. Las clases Cat y Dog evidencia el polimorfismo 

using System; 

using System. Collections ; 

namespace PolyMorphism 

{ 

abstract class Animal 

{ 

public abstract void MakeNoise(); 

} 

class Cat : Animal 

{ 

public override void MakeNoise() 

{ 

Consolé.WriteLine("Meow!"); 



class Dog : Animal 

{ 

public override void MakeNoise() 

{ 

Consolé.WriteLine("Woof!"); 



class PolyMorphism 

{ 

static int Main(string[ ] args) 

{ 

ArrayList Zoo; 

Zoo = new ArrayList(3 ) ; 

Cat Sasha, Koshka; 

Sasha = new Cat(); 

Koshka = new Cat () ; 

Dog Milou; 

Milou - new Dog(); 

Zoo.Add(Milou) ; 

Zoo.Add(Koshka ) ; 

Zoo.Add(Sasha ) ; 
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foreach (Animal a in Zoo) 
{ 

a.MakeNois e{) ; 

} 


// espera a que el usuario acepte los resultados 
Consolé .WnteLine ("Hit Enter to termínate..."); 
Consolé.Read(); 
r e t u r n 0 ; 



Resumen 


CU es un lenguaje orientado a objetos y los conceptos que se usan en los 
lenguajes orientados a objetos también se aplican a C#. 

Los tipos de dalos abstractos son tipos de datos que se definen en el propio 
código. Los tipos de datos abstractos no forman parte de C#. a diferencia de los 
tipos de datos primitivos. Se pueden usar tipos de datos abstractos en el código de 
la misma forma que los tipos de datos primitivos, pero sólo después de haberlos 
definido en el código. 

La encapsulación es el acto de diseñar clases que proporcionen un conjunto 
completo de funcionalidad a los datos de las clases sin exponer directamente esos 
datos. Si se quiere escribir codigo que evite que otras partes del código proporcio¬ 
nen valores no válidos a la clase, la encapsulacion permite "ocultar" los miembros 
de datos al hacerlos privados, mientras crea métodos que acceden a ellos y esta¬ 
blecen los v alores de los miembros de datos como públicos. Otros fragmentos de 
codigo pueden llamar a los métodos, que pueden comprobar los valores y emitir 
un error si los v alores no son apropiados. 

La herencia permite definir una clase por medio de otra. Las clases derivadas 
heredan de la clase base. Las clases deriv adas automáticamente heredan el estado 
v los comportamientos de la clase base. Se puede usar la herencia para añadir 
nuev as funciones a clases ya existentes sin necesidad de rescribir desde cero una 
clase completamente nueva. Algunos lenguajes orientados a objetos permiten tan¬ 
to herencias simples como herencias múltiples, aunque CU solo permite la heren¬ 
cia simple. 

El polimorfismo permite tratar de forma uniforme a una colección de clases 
derivadas de una sola clase base. Las clases derivadas se recuperan como una 
clase base y C# automáticamente llama al método correcto en la clase deriv ada. 

Este capítulo trata los conceptos orientados a objetos en general, sin estudiar 
cómo se usan estos conceptos en el código CU. El resto de los capítulos de esta 
parte del libro explican como se implementan estos conceptos en CU. 
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Clases 
de C# 


El diseño de CU está muy influido por los conceptos del desarrollo de software 
orientado a objetos. Como la clase es la parte fundamental del software orientado 
a objetos, no es de sorprender que las clases sean el concepto más importante de 
C#. Las clases en el mundo del desarrollo de software orientado a objetos contie¬ 
nen codigo v datos. En CU. los datos se implementan usando miembros de datos y 
el código se implementa usando métodos. Los miembros de datos son cualquier 
elemento al que se pueda pasar datos dentro y fuera de la clase. Los dos princi¬ 
pales tipos de miembros de datos son los campos y las propiedades. En el codigo 
CU se pueden escribir tantos miembros de datos y métodos como se desee, pero 
todos deben incluirse en una o varias clases. El compilador de CU emite un error 
si se intenta definir alguna variable o se implementa algún método fuera de una 
definición de clase. Este capítulo trata de los fundamentos de la construcción de 
clases. Explica como crear constructores y destructores, añadir métodos y miem¬ 
bros. además de a usar clases después de crearlos. 

Cómo declarar una clase 

La acción de declarar una clase resulta similar a declarar una estructura. La 
principal diferencia reside en que la declaración empieza con la palabra clave de 



C# class y no con struct. Aunque ya hemos visto una definición de clase en 
anteriores capítulos, vamos a revisar el diseño de una declaración de clase: 

• Modificadores de clase opcionales 

• La palabra clave class 

• Un identificador que da nombre a la clase 

• Información opcional de la clase base 

• El cuerpo de la clase 

• Un punto y coma opcional 

La declaración de clase mínima en C# es parecida a lo siguiente: 

class MyClass 
{ 

} 


Las llaves delimitan el cuerpo de la clase. Los métodos y variables de clase se 
colocan entre las llaves. 

El método Main 

Cada aplicación de C# debe contener un método llamado Main. Esto es el 
punto de entrada para que la aplicación se ejecute. Se puede colocar este método 
dentro de cualquier clase del proyecto porque el compilador es lo bastante inteli¬ 
gente como para buscarlo cuando lo necesite. 

El método Main debe cumplir dos requisitos especiales para que la aplicación 
funcione correctamente. En primer lugar, el método debe declararse como public. 
Esto asegura que se pueda acceder al método. En segundo lugar, el método debe 
declararse como static. La palabra clave static asegura que sólo se puede 
abrir una copia del método a la vez. 

Teniendo en cuenta estas reglas, observemos este código: 

class Classl 

{ 

public static void Main() 

{ 

} 

} 


Como puede apreciarse, este ejemplo contiene una clase llamada Classl. 
Esta clase contiene el método Main de la aplicación. Es en este método Main 
donde se coloca todo el código necesario para ejecutar su aplicación. Aunque es 
correcto colocar este método en la misma clase y el mismo archivo que el resto del 
código de la aplicación, conviene crear una clase y un archivo separados para el 
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método Main. Esta operación sirve de ayuda a los demás programadores que 
quieran trabajar con este código. 

Cómo usar argumentos de línea de comandos 

Muchas de las aplicaciones de la plataforma Windows aceptan parámetros de 
línea de comandos. Para aceptar parámetros de línea de comandos dentro la apli¬ 
cación C#. es necesario declarar una matriz de cadenas como único parámetro del 
método Main, como se puede apreciar en el siguiente codigo: 

elas s Clas s1 

{ 

public static void Main(string[] args) 

{ 

foreach (string arg in args) 

System.Consolé.WriteLine(arg); 

} 

} 

Aquí, el método Main está contenido en una clase típica. Observe que el 
método Main tiene un parámetro definido, una matriz de cadenas que será alma¬ 
cenada en la variable args. Usa el comando foreach para recorrer todas las 
cadenas almacenadas déla matriz args y a continuación se escriben esas cade¬ 
nas en la consola. 


NOTA: Si se está usando Visual Studio .NET para programar C#, la ma¬ 
triz de cadenas se añade automáticamente cuando se crea una aplicación de 
consola. 


Si se ejecuta la aplicación anterior sin parametros, no ocurrirá nada. Si se 
ejecuta una aplicación como la siguiente: 

Sdmpledp.exe parameter 1 parame Leí 2 

el resultado será algo como esto: 

pa r ame t. e r 1 
parame t. e r 2 

Los argumentos de línea de comando son un modo excelente de proporcionar 
modificadores a la aplicación: por ejemplo, para activar un archivo de registro 
mientras se ejecuta la aplicación. 

Cómo devolver valores 

Cuando se crea una aplicación, suele ser útil devolver un valor a la aplicación 
que la inició. Este valor indica al programa que hace la llamada o a la secuencia 


207 




de comandos por lotes si el programa se ejecutó con éxito o falló. Para ello, basta 
con asignar al método Main un valor de devolución int en lugar de void. 
Cuando el método Main está listo para finalizar, sólo hay que usar la palabra 
clave return y un valor que devolver, como se puede apreciar en el siguiente 
ejemplo: 

class Classl 


public static int Main(stríng[ ] args) 
{ 

íf (args[0] == "fail") 
return i; 
return 0; 

} 


Esta aplicación acepta un parámetro fail o cualquier otra palabra (quizás, 
success). Si la palabra fail se pasa a esta aplicación como parámetro, el 
programa devuelve el valor 1. lo que índica un fallo en el programa. En caso 
contrario, el programa devuelve 0. lo que indica que el programa finalizó con 
normalidad. Se puede comprobar el funcionamiento del programa simplemente 
haciendo que un archivo por lotes ejecute la aplicación y que luego realice algu¬ 
nas acciones dependiendo del código devuelto. El siguiente código es un simple 
archivo por lotes que realiza esta función: 

@echo off 

retval.exe success 
goto answer'errorlevel 
:answer0 

echo Program had return code 0 (Success) 
goto end 

:answer1 

echo Program had return code 1 (Failure) 
goto end 

: end 

echo Done! 

En el código anterior se puede apreciar que se llama al programa con un 
parámetro success. Al ejecutar este programa por lotes, aparece el siguiente 
mensaje: 

Program had return code 0 (Success) 

Si se edita este programa por lotes para que pase la palabra fail como 
parámetro, entonces aparecerá un mensaje que confirma que el programa terminó 
con un código de salida 1. 
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El cuerpo de la clase 

El cuerpo de la clase puede incluir instrucciones cuya función se incluya en 
una de estas categorías. 

• Constantes 

• Campos 

• Métodos 

• Propiedades 

• Eventos 

• Indizadores 

• Operadores 

• Constructores 

• Destructores 

• Tipos 

Cómo usar constantes 

Las constantes de clase son variables cuyo valor no cambia. El uso de cons¬ 
tantes permite que el código resulte más legible porque pueden incluir 
idcntificadores que describan el significado del valor a cualquiera que lea el códi- 
go. Se puede escribir un código como el siguiente: 

if(Ratio = = 3.14159) 

System. Consolé. WnteLine ("Shape is a circle" ) ; 

El compilador de C# acepta perfectamente este código, pero puede ser un poco 
difícil de leer, especialmente para alguien que lea código por primera vez y se 
pregunte qué es el valor de coma flotante. Si se le da un nombre a la constante, 
por ejemplo pi. se puede escribir el siguiente código: 

if(Ratio == Pi) 

System.Consolé.WriteLine("Shape is a circle"); 

El uso de constantes presenta otras ventajas: 

• Se le da valor a las constantes cuando se las declara y se usa su nombre, no 
su valor, en el código. Si por alguna razón es necesario cambiar el valor de 
la constante, sólo hace falta cambiarlo en un sitio: donde se declara la 
constante. Si se escribe en las instrucciones de C# el valor real, un cambio 
en el valor significaría que habría que revisar todo el código y cambiar ese 
valor. 
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• Las constantes indican específicamente al compilador de C# que. a dife¬ 
rencia de las variables normales, el valor de la constante no puede cam¬ 
biar El compilador de C,# emite un error si algún código intenta cambiar el 
valor de una constante. 

La estructura de la declaración de una constante es la siguiente: 

• La palabra clave const 

• Un tipo de dato para la constante 

• Un identificador 

• Un signo igual 

• FJ valor de la constante 

La definición de una constante para pi sería: 

class MyClass 

I 

public const double Pi - 3.1415926535897932384626433832795; 

pubiic static void Mam() 

{ 

} 


NOTA: Este capítulo usa la palabra clave public para indicar que los 
elementos del cuerpo de clase están disponibles para el resto del código de 
la aplicación. Posteriormente se examinan algunas alternativas a la palabra 
clave public que pueden usarse cuando se hereda una clase de otra. 


('# permite colocar varias definiciones de constantes en la misma linea, siem¬ 
pre que todas las constantes tengan el mismo tipo. Se pueden separar las defini¬ 
ciones de constantes con una coma, como en el siguiente ejemplo: 

■vi a.ss MyC í ass 

pub i i c const i nt. One = .1* Two - 2, Three = 3; 

p i j b i i c s t a t i. c v o i d Ma mí) 
í 



Cómo usar campos 

Los campos son miembros de datos de una clase. Son variables que pertenecen 
a una clase y. en términos de programación orientada a objetos, gestionan el 
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estado de la clase. Se puede acceder a los campos definidos en una clase me¬ 
diante cualquier método definido en la misma clase. 

Un campo se define exactamente igual que cualquier variable. Los campos 
tienen un tipo y un identificador. También se puede definir un campo sin un valor 
inicial: 

cíass MyClass 
{ 

public int Fieldl; 

public static void Main() 

{ 

} 

} 

También se puede definir un campo con un valor inicial: 

class MyClass 
{ 

public int Fieldl = 123; 

public static void Main() 

{ 

} 

} 

Para indicar que los campos son de sólo lectura escriba antes de la declaración 
la palabra clave readonly. Si usa la palabra clave readonly. deberá escri¬ 
birla justo antes del tipo del campo: 

class MyClass 
{ 

public readonly int Fieldl; 
public static void Main() 

í 

} 

} 

Se puede establecer el valor de un campo de sólo lectura al declarar el campo 
o en el constructor de la clase. Su valor no puede establecerse en ningún otro 
momento. Cualquier intento de cambiar el valor de un campo de sólo lectura es 
detectado por el compilador de C# y devuelve un error: 

error CS0191: No se puede asignar un campo de solo lectura 
(excepto en un constructor o inicializador de variable) 

Los campos de sólo lectura se parecen a las constantes en la medida en que 
se inicializan cuando se crea un objeto de la clase. La principal diferencia entre 
una constante y un campo de sólo lectura es que el valor de las constantes debe 
establecerse en tiempo de compilación; en otras palabras, deben recibir su valor 
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cuando se escribe el código. Los campos de sólo lectura permiten establecer el 
valor del campo en tiempo de ejecución Como se puede asignar el valor de un 
campo de sólo lectura en un constructor de clase, se puede determinar su valor 
en tiempo de ejecución y establecerlo cuando el código se está ejecutando. 

Supongamos, por ejemplo, que estamos escribiendo una clase de C# que ges¬ 
tiona la lectura de un grupo de archivos de una base de datos. Quizás queramos 
que la clase publique un valor que especifique el numero de archivos que hay en la 
base de datos. 

Una constante no es la elección correcta para este valor porque el valor de una 
constante debe establecerse cuando se escribe el código y no podemos saber cuan¬ 
tos archivos contiene la clase hasta que se ejecute el codigo. Podemos poner estos 
datos en un campo cuyo valor puede establecerse después de que la clase haya 
empezado a ejecutarse y se puede determinar el numero de archivos. Como el 
numero de archiv os no cambia durante la existencia de la clase, quizás queramos 
señalar el campo como de solo lectura para que los otros fragmentos de código no 
puedan cambiar su valor. 

Cómo usar métodos 

Los métodos son bloques de codigo con nombre en una clase. Los métodos 
proporcionan los comportamientos de las clases. Pueden ejecutarse por cualquier 
otro fragmento de código en la clase y. como se explicará en un capítulo poste¬ 
rior. también pueden ejecutarlos otras clases. 

Cómo usar propiedades 

En un capítulo anterior se examina la estructura Point que puede describir 
un punto en una pantalla con una resolución de 640 x 480 píxeles. Un modo de 
implementar esta estructura es definirla con miembros de datos públicos que des¬ 
criban las coordenadas del punto: 

st.ruct P o i n t 
{ 

p u b 1 1 c i n t X ; 
public int Y; 

} 

AI usar una estructura como ésta, los clientes pueden usar la sintaxis 
structurename.field para trabajar con uno de los campos de la estructura: 

Point MyPoint = new Point(); 

MyPoint.X - i 0 U; 

Los clientes pueden escribir fácilmente este código. Los clientes pueden acce¬ 
der al campo directamente y usar su valor en una expresión. 
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El problema de este enfoque es que los clientes pueden establecer un campo 
que C# permite, pero que no es logico para el código. Por ejemplo, si esta gestio¬ 
nando una estructura Point que describe un punto en una pantalla de 640 \ 480 
pixeles. el valor lógico mas alto para X debería ser 630 (suponiendo que los 
valores legales de X están entre 0 y 639). Sin embargo, como se especifica que la 
coordenada X es un tipo int. los clientes pueden establecer como valor cualquier 
valor autorizado dentro de los límites de los tipos enteros: 

MyPoint.X - -bOO; 

MyPoint.X = 9000; 

El compilador C# acepta este código porque los valores que se asignan a X 
están dentro de los límites válidos para los valores enteros. 

Una solución a este problema es hacer que los valores sean privados, con lo 
que serían inaccesibles para otros fragmentos de código y luego añadir un método 
público a la estructura que establece los valores de X: 

struct Point 
{ 

private int X; 
prívate int Y; 

publie bool SetX (int NewXValue) 

{ 

if ( (NewXValue < U) | | (NewXValue > r 39) ) 
return false; 

X = NewXValue; 

return true; 

} 

} 

La ventaja de este enfoque es que obliga a los clientes que quieran asignar un 
valor a X a llamar al método para realizar la tarea: 

Point My Point = new Point(); 

MyPoint.SetX ( 100) ; 

La ventaja del método es que se puede escribir código que valide el nuevo 
valor antes de que se almacene realmente en el campo y el código del método 
puede rechazar el nuevo valor si. por lógica, no es adecuado. Así pues, los clien¬ 
tes llaman al método para establecer un nuevo valor. 

Aunque este enfoque funciona, llamar a un método para asignar un valor re¬ 
quiere un poco mas de código que asignar un valor directamente. Para el código 
es mas natural asignar un valor a un campo que llamar a un método para que lo 
asigne. 

En el mejor de los casos, querremos lo mejor de los dos elementos: que los 
clientes puedan leer y escribir directamente los valores de los campos usando 
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instrucciones de asignación simples, pero también querremos que el código inter¬ 
venga por anticipado y haga todo lo necesario para obtener el valor de un campo 
o validar el nuevo valor antes de que se asigne. Afortunadamente, C# ofrece esta 
posibilidad con un concepto de clase llamado propiedad. 

Las propiedades son miembros identificados que proporcionan acceso al esta¬ 
do de un objeto. Las propiedades tienen un tipo y un identificador y tienen uno o 
dos fragmentos de código asociados a ellos: una base de código get y una base 
de código set. Estas bases de código reciben el nombre de descriptores de acce¬ 
so. Cuando un cliente accede a una propiedad se ejecuta el descriptor de acceso 
get de la propiedad. Cuando el cliente establece un nuevo valor para la propie¬ 
dad se ejecuta el descriptor de acceso set de la propiedad. 

Para mostrar cómo funcionan las propiedades, el listado 9.1 usa una clase 
Point que expone los valores de X e Y como propiedades. 

Listado 9.1. Valores Point como propiedades de clase 

class Point 
{ 

prívate int XCoordinate; 
prívate int YCoordinate; 

public int X 
{ 

get 

{ 

return XCoordinate; 

} 

set 

{ 

íf{(valué >= 0) && (valué < 640)) 

XCoordinate = valué; 

} 

} 


public int Y 
{ 

get 

{ 

return YCoordinate; 

} 

set 

{ 

if ( (valué > = 0) && (valué < 480)) 

YCoordinate = valué; 

} 


public static void Main() 

{ 

Point MyPoint = new Point(); 
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MyPoint .X = 100; 

MyPoint.Y - 200 ; 

System. Consolé .WríteLme (MyPomt.X) ; 

System.Consolé.WriteLine(MyPoint.Y); 

MyPoint.X = 600 ; 

MyPoint.Y = 600; 

System.Consolé.WriteLine(MyPoint.X); 

System.Consolé.WriteLine(MyPoint.Y); 

} 

} 

Este codigo declara una clase Point con los valores X e Y como propieda¬ 
des. El método Main ( ) crea un nuevo objeto de la clase Point y accede a las 
propiedades de la clase. 

La clase Point define dos campos privados que contienen los valores de las 
coordenadas del punto. Como estos campos son privados, el código que se en¬ 
cuentra fuera de la clase Point no puede acceder a sus valores. La clase también 
define dos propiedades publicas que permiten que otros fragmentos de código 
trabajen con los valores de las coordenadas del punto. Las propiedades son publi¬ 
cas y pueden ser usadas por otras partes del codigo. La propiedad X es la propie¬ 
dad pública que gestiona el valor del campo privado XCoord i na te y la propiedad 
Y es la propiedad pública que gestiona el valor del campo privado YCoord i na te. 
Las dos propiedades tienen un descriptor de acceso get y otro set. La figura 
9.1 muestra el resultado del listado 9.1. 



Figura 9.1. Las propiedades de clase ayudan a almacenar los valores del punto 


Descriptores de acceso get 

Los descriptores de acceso get solamente devuelven el valor actual del campo 
correspondiente: el descriptor de acceso de la propiedad X devuelve el valoi ac- 
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tual de Xcoordinate y el descriptor de acceso de la propiedad Y devuelve el 
valor actual de Ycoordinate. 

Cada descriptor de acceso get debe devolver un valor que coincida o pueda 
ser convertido implícitamente al tipo de la propiedad. Si el descriptor de acceso 
no devuelve un valor, el compilador de C# emite el siguiente mensaje de error: 

error CS0161: 'MyClass.Property.get' : no todas las rutas de 

codigo devuelven un valor 

Descriptores de acceso set 

Los descriptores de acceso set del ejemplo son un poco más complicados 
porque tienen que validar el nuevo valor antes de que sea realmente asignado al 
campo asociado. 

Observe que el descriptor de acceso usa la palabra clave valué. El valor de 
este identificador es el valor de la expresión que aparece después del signo de 
igualdad cuando se llama al descriptor de acceso set. Por ejemplo, examine la 
siguiente instrucción del listado 9.1: 

MyPoint.X - 100; 

El compilador de C# determina que la instrucción está asignando un nuevo 
valor a la propiedad X del objeto Point . Ejecuta el descriptor de acceso set de 
la clase para realizar la asignación. Como se está asignando a la propiedad el 
valor 100. el valor de la palabra clave valué del descriptor de acceso set será 
100 . 

Los descriptores de acceso set del listado 9.1 asignan el valor al campo 
correspondiente, pero sólo si el valor está dentro de los límites válidos. En C#. no 
esta permitido devolver valores de los descriptores de acceso. 



Propiedades de sólo lectura y de sólo escritura 

Las propiedades del listado 9.1 pueden leerse usando su descriptor de acceso 
get y puede escribirse en ellas usando su descriptor de acceso set. Estas pro¬ 
piedades reciben el nombre de propiedades de lectura y escritura. Cuando se 
diseñan las clases de C#. hay que implementar una propiedad de sólo lectura o de 
sólo escritura. En C#. esto es sencillo. 

Si hace falta implementar una propiedad de sólo lectura, se especifica una 
propiedad con un descriptor de acceso get pero sin descriptor de acceso set: 
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mt X 


ge t 

í 

return XCoordinate; 


Si hace falta implcmcntar una propiedad de solo escritura, se especifica una 
propiedad con un descriptor de acceso set pero sin descriptor de acceso get. 

;int X 
{ 

set 

{ 

i i ( (valué > = 0) & & (valué < 6 40)) 

XCoordinate = valué; 



Cómo usar eventos 

CU permite que las clases informen a otras partes del codigo cuando se produ¬ 
ce una acción sobre ella en la clase. Esta capacidad recibe el nombre de mecanis¬ 
mo de evento x permite informar a los elementos que realizaron la llamada si se 
produce un evento en la clase de C# Puede diseñar clases de CU que informen a 
otros fragmentos de código cuando se produzcan determinados eventos en la cla¬ 
se. La clase puede devolver una notificación de evento al fragmento de código 
original. Quizás quiera usar un evento para informar a otros fragmentos de códi¬ 
go de que se ha completado una operación muy larga. Suponga, por ejemplo, que 
quiere diseñar una clase de CU que lea una base de datos. Si la actividad sobre la 
base de datos va a requerir mucho tiempo, será mejor que otras partes del código 
realicen otras acciones mientras se lee la base de datos. Cuando se completa la 
lectura, la clase de C U puede emitir un evento que indique "la lectura se ha com¬ 
pletado". También se puede informar a otras partes del codigo cuando se emita 
este evento v el codigo puede realizar la acción indicada cuando reciba el evento 
de la clase de CU. 

Cómo usar indizadores 

Algunas de las clases pueden actuar como contenedores de otros valores. 

Supongamos, por ejemplo, que estamos escribiendo una clase de CU llamada 
Rainbow que permite a los clientes acceder a los valores de cadenas que nom¬ 
bran los colores del arco iris en orden. Queremos que los elementos que realizan 
llamadas puedan retirar los valores de las cadenas, de modo que usamos algunos 
métodos públicos que permiten a los elementos que realizan llamadas tener acceso 
a los valores. El listado 9.2 muestra un ejemplo de este tipo de codigo. 
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Listado 9.2. Una clase con un conjunto de valores de cadena 


class Rainbow 

{ 

public int GetNumberOfColors() 
{ 

return 7; 

} 


public bool GetColor (mt Colorlndex, out stnng ColorName) 

í 

bool ReturnValue; 

ReturnValue = true; 
switch(Colorlndex) 

{ 


case 0: 


ColorName - 

break; 

case 1 : 

"Red"; 

ColorName - 

break; 

case 2: 

"Orange 

ColorName = 

break; 

case 3 : 

"Yellow 

ColorName = 

break; 

case i : 

"Green" 

ColorName = 

break; 

case 5: 

"Blue"; 

ColorName = 

break; 

case 6: 

"Indigo' 

ColorName - 

break; 

def ault: 

"Violet' 

ColorName - 

" H . 

ReturnValue 

break; 

= false; 


} 

return ReturnValue; 


public static void Main() 

{ 

mt ColorCount; 
int Colorlndex; 

Rainbow MyRainbow = new Rainbow(); 
ColorCount = MyRainbow.GetNumberOfColors () ; 
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string ColorName; 
bool Success; 


for(Colorlndex = 0; Colorlndex < ColorCount; ColorIndex++) 

{ 

Success = MyRainbow.GetColor(Color Index, out 
ColorName); 

if (Success = = true) 

System.Consolé.WriteLine(Colo r Ñame ) ; 

} 



La clase Rainbow del listado 9.2 tiene dos métodos públicos: 

• GetColorCount ( ) . que devuelve el número de colores de la clase 

• GetColor ( ). que. basándose en un numero de color, devuelve el nom¬ 
bre de uno de los colores de la clase 

El método Main() crea un nuevo objeto de la clase Rainbow y pide al 
objeto el numero de colores que contiene. A continuación se coloca en un bucle 
f or y solicita el nombre de cada color. El nombre del color aparece en la conso¬ 
la El resultado de esta aplicación puede verse en la figura 9.2 



Figura 9.2. Los indizadores recuperan los nombres de los colores 


La clase mantiene una colección de valores del mismo tipo de valor, lo que es 
muv parecido a una matriz. De hecho, esta clase Rainbow también puede 
implementarse como una matriz y el elemento que realiza la llamada puede usar 
los corchetes de la sintaxis del descriptor de acceso a la matriz de elementos para 
recuperar un nombre de color en particular: 


ColorName 


Rainbow[ColorIndex] ; 






Los indizadorcs permiten que se acceda a las clases como si fuera una matriz. 
Para especificar qué se debe devolver cuando el elemento que hace la llamada usa 
corchetes para acceder al elemento de la clase, se usa un fragmento de código 
llamado descriptor de acceso de indicador. 

Teniendo esto en cuenta, se puede reescribir la clase Rainbow para que 
permita a los elementos que la llaman acceder a los nombres de los colores usan¬ 
do corchetes en su sintaxis. Se elimina el método GetColor ( ) v se sustituye 
por un indizador. y se sustituye el método GetColorCount ( ) por una propie¬ 
dad de sólo lectura llamada Count. como se muestra en el listado 9.3. 

Listado 9.3. Clase Rainbow con un indizador 


el ass Rainbow 
{ 

public int Count 
{ 

ge t 


return 


7; 


public stnng this[int Color Index] 
{ 

ge t 


switch(Colorlndex) 


case 0 : 


return 

"Red"; 

case 1 : 


return 

"Orange 

case 2 : 


return 

"Ye11ow 

case 3 : 


return 

"Creen" 

case 4 : 


return 

"Blue"; 

case 5: 


return 

"Indigo 1 

case 6: 


return 

"Violet 1 

def ault: 


return 

" " ; 


public static void Main() 
{ 

int Colorlndex; 
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Rainbow MyRainbow = new Rainbow(); 


string ColorName; 

for (Color Index = 0; Color Index < MyRainbow.Count; 

Coloríndex++) 

{ 

ColorName = MyRainbow[ColorIndex ] ; 

System. Consolé .WriteLme (ColorName ) ; 


} 

Los indizadores se parecen a las propiedades porque tienen descriptores de 
acceso get v set. Si fuera necesario, se puede omitir cualquiera de estos 
descriptores de acceso. El indizador del listado 9.3 no tiene el descriptoi de acce¬ 
so set, lo que significa que la clase se puede leer, pero no se puede esciibii en 
ella. 

Los indizadores se estructuran según los siguientes elementos: 

• Un tipo que indica el tipo de datos que devuelve el descriptor de acceso 

• La palabra clave this. 

• Un corchete de apertura. 

• Una lista de parámetros, estructurada igual que una lista de parámetros de 
un método. 

• Un corchete de cierre. 

• Un cuerpo de código, entre llaves. 

El indizador del listado 9.4 recibe un argumento integral y devuelve una cade¬ 
na. de forma parecida al método GetColor ( ) del listado 9.2. 

Listado 9.4. Un argumento entero que devuelve una cadena 

string ColorName; 

for(Colorlndex = 0; Colorlndex < MyRainbow.Count; ColorIndex++) 


ColorName = MyRainbow[ColorIndex]; 

System.Consolé.WriteLine(ColorName); 

} 

El nuevo código usa los corchetes de la sintaxis del elemento de matriz para 
obtener el nombre de un color del objeto MyRainbow. Esto hace que el compilador 
de C# llame al código indizador de la clase, que pasa el valor de Colorlndex 
como parámetro. El indizador devuelve una cadena y la cadena se escribe en la 
consola. 
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Una clase puede implementar más de un indizador. siempre que los indizadores 
tengan diferentes listas de parámetros. Las listas de parámetros de los indizadores 
pueden tener más de un parámetro y pueden ser de cualquier tipo que se pueda 
usar en el código. No es necesario que los indizadores usen valores enteros como 
indizadores. Se podría haber implementado igualmente en la clase Rainbow un 
indizador que aceptase un valor double: 

public string this[double Colorlndex] 


NOTA: Como en las propiedades, C# no permite que los descriptores de 
acceso set devuelvan valores. Sin embargo, pueden usarse excepciones 
para informar de cualquier error. 


Cómo usar operadores 

Un operador permite definir el comportamiento de la clase cuando se usa en 
una expresión con un operador unario o binario. Esto significa que se puede 
ampliar el comportamiento de operadores predefinidos para que se ajusten a las 
necesidades de las clases. Por ejemplo, la clase Point puede implemcntar códi¬ 
go que especifique que se pueden sumar dos objetos Point con el operador +. El 
resultado de la suma sera un tercer objeto Point cu>o estado es el resultado de 
sumar los otros dos puntos 

Cómo usar constructores 

Los constructores de estructura son métodos especiales que se ejecutan cuan¬ 
do se crea una variable del tipo de la estructura. Los constructores suelen usarse 
para inicializar una estructura con un estado conocido. 

Se pueden usar constructores en las clases de C# de la misma forma que las 
estructuras. Se pueden definir tantos constructores como se desee, siempre que 
cada constructor tenga una lista de parámetros diferente. Se puede escribir una 
clase Point con constructores de la misma forma que se hizo con la estructura 
Poi nt. como se puede apreciar en el listado L ).5. 

Listado 9.5. Una clase Point con dos constructores 


c1a s s Point 

i 

public int X; 
public int Y; 

public Point() 
{ 

X - 0; 
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Y 


0; 


public Point(int InitialX, int InitialY) 
{ 

X = InitialX; 

Y = InitialY; 


public static void Main() 

{ 

Point MyFirstPoint = new Point(100, 200); 

Point MyS econdPoint = new Point() ; 

} 

} 

La clase Point del listado 9.5 tiene dos campos públicos: X e Y. También 
miplementa dos constructores. Uno de ellos no usa ningún parámetro y el otro usa 
dos parámetros. Los constructores de las clases de C# son muy parecidas a las 
estructuras de C#. Los constructores de clase no devuelven valores y su nombre 
debe coincidir con el nombre de la clase. La principal diferencia entre los cons¬ 
tructores de estructura y los constructores de clase estriba en que los constructores 
de clase pueden implementar un constructor sin parámetros, pero un constructor 
de estructura no puede hacerlo. 

Si se define una clase sin constructores. C# proporciona un constructor por 
defecto. Este constructor por defecto asigna a todos los campos de las clases sus 
valores por defecto. Si se inicializa con el signo igual cualquier campo de una 
clase, éste se micializará antes de que se ejecute el constructor: 

class Point 

{ 

public int X = 100; 
public int Y; 

public Point(int InitialY) 

{ 

Y m InitialY + X; 


En esta clase Point, una declaración de asignación inicializa el campo X y el 
constructor y inicializa el campo Y. Al compilar este código, el compilador de C# 
se asegura de que el campo X se inicial ice en primer lugar. 

Cómo usar destructores 

Las clases de C# pueden definir un destructor, que es un método especial que 
se ejecuta cuando el CLR (Entorno común de ejecución) destruye los objetos de 
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la clase. Puede pensar en los destructores como en lo contrario de los construc¬ 
tores: los constructores se ejecutan cuando se crean objetos y los destructores se 
ejecutan cuando el recolector de objetos no utilizados destruye los objetos. Este 
proceso tiene lugar de modo oculto sin consecuencias para el programador. 

Los destructores son opcionales. Es perfectamente válido escribir una clase 
de C# sin un destructor (y hasta ahora, es lo que hemos estado haciendo en los 
ejemplos). Si se escribe un destructor, sólo se puede escribir uno. 


NOTA: A diferencia de los constructores, no se puede definir más de un 
destructor para tina clase. 


Los destructores se disponen de la siguiente forma: 

• El símbolo virgulilla (~). 

• El identifícador del destructor, que debe corresponder al nombre de la 
clase. 

• Un conjunto de paréntesis. 

El listado 9.6 actualiza la clase Point del listado 9.5 con un destructor: 
Listado 9.6. Una clase Point con un destructor 


class Point 
{ 

public int X; 
public int Y; 

public Point() 
{ 

X - 0; 

Y = 0; 

} 


public Point(int InitialX, int InitialY) 
{ 

X = I n i 1 1 a 1X ; 

Y = InitialY; 


"Point. ( ) 

{ 

X - 0; 

Y - 0; 

} 

public st.atic void Main() 
{ 
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Point MyFirstPoint = new Point(100, 2 0 0); 
Point MySecondPoint = new Point(); 


} 

Los destructores no devuelven valores: ni tampoco pueden aceptar parametros. 
Si se intenta llamar a un destructor en el código, el compilador de C# emite un 
error. 

En muchos lenguajes orientados a objetos, se llama a los destructores de clase 
cuando la variable ya no puede ser usada. Supongamos, por ejemplo, que escribi¬ 
mos un método y declaramos un objeto Point como una variable local del meto- 
do. Cuando se llama al método, se crea el objeto Point y el método puede 
trabajar con él. Cuando el método llega al final de su bloque de código, el objeto 
Point ya no volverá a usarse En lenguajes como C++. esto hace que se llame al 
constructor de la clase cuando acaba el método. 

En C#. esto no tiene por qué ocurrir De hecho, no se puede llamar a un 
destructor de clase. Recuerde que el CLR ¡mplementa una utilidad llamada 
recolector de objetos no utilizados que destruye objetos que ya no se usan en el 
código. La recolección puede tener lugar mucho después de que el objeto deje de 
ser accesible. Observ e el método Main ( ) en el listado 9.7: 

Listado 9.7. Demostración del uso del recolector de objetos no utilizados 
mediante la estructura Point 

pubiic static void Main() 

{ 

Point MyFirstPoint = new Point(100, 200); 

Point MySecondPoint = new Point(); 

} 


El método Main () crea dos objetos locales Point. Cuando el método Main () 
termina su ejecución, los objetos locales Point ya no pueden volver a ser usados 
y el CLR los registra como objetos que pueden ser destruidos cuando se ejecute el 
recolector de objetos no utilizados. Sin embargo, el recolector de objetos no uti¬ 
lizados no siempre se ejecuta inmediatamente, lo que significa que no siempre se 
llama al destructor del objeto inmediatamente. 


NOTA: Se llama a los destructores de las clases de C# cuando se destruye 
un objeto, no cuando su variable deja de ser accesible. 


Por ejemplo, suponga que quiere escribir una clase de C# que gestione un 
archivo en un disco. Escribiremos una clase llamada File con un constructor 
que abra el archivo y un destructor que cierre el archivo: 

class File 
{ 
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File (stnng Ñame) 


{ 

// abre el archivo 


~ Fi 1 e ( ) 

{ 

// cierra el archivo 

} 


Si queremos que esta clase trabaje en un método: 

public static void Main{) 

{ 

File MyFile = new File { "myfile.txt" ) ; 

} 

El destructor de la clase File cierra el archivo, pero en realidad el destructor 
no se ejecuta hasta que el recolector de objetos no utilizados no se activa. Esto 
significa que el archivo puede todavia estar abierto mucho después de que la 
variable MyFile sea inaccesible. Para asegurarnos de que el archivo se cierra lo 
antes posible, añadimos a la clase File un método Cióse ( ). que cierra el 
archivo cuando se le llama. 



Cómo usar los tipos de clase 

Las clases pueden usar uno de los tipos integrados en C# (int, long o 
char, por ejemplo) y pueden definir sus propios tipos. Las clases pueden incluir 
declaraciones de otros elementos, como estructuras o incluso otras clases. 


Cómo usar la palabra clave this como 
identificador 


En C# se puede emplear la palabra clave this para identificar un objeto cuyo 
código se está ejecutando, lo que a su vez permite hacer referencia a ese objeto. 

La palabra clave this se puede emplear de varias maneras. Ya hemos visto 
como se usa en un indizador. También se puede usar como prefijo de un 
identificador de variable para advertir al compilador de que una determinada 
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expresión debe hacer referencia a un campo de clase. Observe, por ejemplo, la 
clase Point en el listado 9.8. 

Listado 9.8. Campos y parámetros con el mismo nombre 


class Point 
{ 

public int X; 
public int Y; 

Point (int X, int Y) 
{ 

X = X; 

Y = Y; 

} 


public static void Main() 


} 

Este codigo no tiene el comportamiento esperado porque los identificadores X 
e Y se emplean en dos ocasiones: como identificadores de campo y en la lista de 
parámetros del constructor. El código debe diferenciar el identificador de campo 
X del identificador de la lista de parámetros X. Si el codigo es ambiguo, el 
compilador de C# interpreta que las referencias a X e Y en las declaraciones del 
constructor se refieren a los parametros y el código establece los parámetros con 
el valor que ya contienen. 

Se puede usar la palabra clave this para diferenciar el identificado! de cam¬ 
po del identificador de parámetro. 

El listado 9.9 muestra el código corregido, usando la palabra clave this 
como prefijo del campo de nombre. 

Listado 9.9. Cómo usar this con campos 


class Point 
{ 

public int X; 
public int Y; 

Point (int X, int Y) 
{ 

this.X = X; 
this.Y = Y; 

} 


public static void Main() 


} 
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El modificador static 


Cuando se define un campo o un método en una clase, cada objeto de esa clase 
creado por el código tiene su propia copia de valores de campo y métodos. Me¬ 
diante la palabra clave static. se puede invalidar este comportamiento, lo que 
permite que varios objetos de la misma clase compartan valores de campo y 
métodos. 

Cómo usar campos estáticos 

Retomemos el ejemplo de la clase Point. Una clase Point. puede tener dos 
campos para las coordenadas .v er del punto. Todos los objetos creados a partir 
de la clase Point tienen copias de esos campos, pero cada objeto puede tener sus 
propios valores para las coordenadas ,v e y. Asignar un valor a las coordenadas ,v 
e v de un objeto no afecta a los valores de otro objeto: 

Point MyFirstPoint = new Point(100, 200); 

Point MySecondPoint - new Point (150, 250); 

En este ejemplo se crean dos objetos de la clase Point. El primer objeto 
asigna a su copia de las coordenadas a* o v los v alores 100 y 200. respectiv amente 
v el segundo objeto asigna a su copia de las coordenadas x e r los valores 150 y 
250. respectivamente. Cada objeto guarda su propia copia de las coordenadas .v e 
y. 

Si se coloca el modificador static antes de una definición de campo se esta 
indicando que todos los objetos de la misma clase compartirán el mismo valor. Si 
un objeto asigna un valor estático, todos los demás objetos de esa misma clase 
compartirán esc mismo valor. Observe el listado ó. 10 

Listado 9.10. Campos estáticos 


class Point 
{ 

public static int XCoordinate; 
pub lie static int '/Coordínate; 

public int X 
{ 

ge t 


} 


) 


return XCoordinate; 


public int Y 
{ 

ge t 
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return YCoordinate; 

} 

} 

public statíc void Main{) 

{ 

Point MyPoint = new Point ( ) ; 

System. Consolé .WnteLine ("Before" ) ; 
System. Consolé. WriteLme ( " = = = -- = ” ) ; 
System.Consolé.WriteLine (My P oin t.X) ; 
System.Consolé. WnteLine (MyPoint . Y) ; 

Point.XCoordíñate - 100; 

Point//Coordínate • 2 00 ; 

System.Consolé.WriteLine("After"); 
System.Consolé.WriteLine("----="); 
System.Consolé.WriteLine(MyPoint.X|; 
System.Consolé.WriteLine(MyPoint.Y)f 



La clase Point del listado 9.10 tiene dos campos estáticos enteros llamados 
XCoordinate e YCoord i nate. También tiene dos propiedades de solo lectu¬ 
ra. llamadas X e Y. que devuelven los valores de las variables estáticas. El método 
Main ( ) crea un nuevo objeto Point y escribe sus coordenadas en la consola. A 
continuación cambia los valores de los campos estáticos y vuelve a escribir las 
coordenadas del objeto Point. El resultado puede verse en la figura 9.3. 



Figura 9.3. El uso de campos estáticos simplifica la codificación 


Hay que tener en cuenta que los valores de las coordenadas del objeto Point 
han cambiado, aunque los valores del propio objeto no hayan cambiado. Esto es 





debido a que el objeto Point comparte campos estáticos con todos los demás 
objetos Point v cuando los campos estáticos de la clase Point cambian, todos 
los objetos de esa clase se ven afectados. 

Los campos estáticos que se usan en expresiones no están prefijados con un 
identificador de objeto sino con el nombre de la clase que contiene los campos 
estáticos. La siguiente instrucción es un error porqueMyPoint hace referencia a 
un obicto v XCoordinate hace referencia a un campo estático: 

MyPoint.XCoordinate = 100; 

Este codigo hace que se produzca el siguiente error del compilador de C#: 

error CS0176: No se puede obtener acceso al miembro estático 

'Point.XCoordi nate' con una referencia de instancia; utilice un 

nombre de tipo en su lugar 

El campo estático debe estar prefijado con el nombre de la clase: 

Point . XCoordinat.e - 10 0; 

Cómo usar constantes estáticas 

Las constantes operan de la misma forma que los campos a menos que estén 
precedidas por la palabra clave static; en ese caso, cada objeto de la clase 
contiene su propia copia de la constante. Sin embargo, hacer que cada objeto de 
una clase contenga su propia copia de una constante supone desperdiciar memo¬ 
ria. Supongamos que estamos escribiendo una clase llamada Circle. que ges¬ 
tiona un círculo. Como estamos trabajando con un círculo, usaremos bastante el 
valor pi. Decidimos que pi sea una constante para referirnos siempre a ella con 
un nombre, en lugar de con un enorme número de coma flotante. 

Ahora bien ¿qué ocurre si creamos mil objetos círculo? Por defecto, cada uno 
de ellos tiene su propia copia de pi en memoria. Esto es un desperdicio de memo¬ 
ria. especialmente porque pi es una constante y su valor nunca cambia. Es más 
lógico que cada objeto de la clase Circle use una sola copia de la constante pi. 

Para eso sirve la palabra clave static. Si se usa la palabra clave static 
con una constante cada objeto de una clase trabaja con una sola copia del valor de 
la constante en memoria: 

const double Pi = 3.1415926535897932384626433832795; 

En general hav que intentar que todas las constantes sean estáticas de modo 
que sólo haya una copia del valor de la constante en memoria a la vez. 

Cómo usar métodos estáticos 

Los métodos que se definen mediante la palabra clave static reciben el 
nombre de métodos estáticos. Los métodos que no se definen mediante la palabra 
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clave static reciben el nombre de métodos de instancia. Los métodos estáticos 
están incluidos en una clase, pero no pertenecen a ningún objeto específico. Igual 
que los campos estáticos y las constantes estáticas, todos los objetos de una clase 
comparten una copia de un método estático. Los métodos estáticos no pueden 
hacer referencia a ninguna parte de un objeto que no esté también marcado como 
estático, como puede apreciarse en el listado 9.11. 

Listado 9.11. Métodos estáticos que llaman a un método de instancia de clase 

class Listing9_9 

{ 

public static void Main() 

{ 

CallMethod(); 

} 

void CallMethod() 

{ 

System.Consolé.WriteLine("Hello from CallMethod()"); 

} 

} 


El código anterior no se compila y el compilador de C# emite el siguiente 
error: 

error CS0120: Se requiere una referencia a objeto para el 
campo, método o propiedad no estáticos 
'Listing9_9.CallMethod () ' 

El error del código del listado 9.11 es que hay un método estático. Main ( ). 
que intenta llamar a un método de instancia. CallMethod ( ) . Esto no está 
permitido porque los métodos de instancia son parte de una instancia de objeto y 
los métodos estáticos no. 

Para corregir el código, el método estático Main ( ) debe crear otro objeto de 
la clase y llamar al método de instancia desde el nuevo objeto, como muestra el 
listado 9 12. 

Listado 9.12. Métodos estáticos que llaman a un método de instancia de clase 

class Listing9_10 
{ 

public static void Main() 

{ 

Listing9_10 MyObject = new Listing9_10(); 

MyObject.CallMethod( ) ; 

} 

void CallMethod() 

{ 
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. Consolé.WriteLine("Helio f rom CallMethod() ") ; 


System 


i 

La figura 9.4 muestra el resultado del listado 9.12. 



Figura 9.4. Ejemplo de una llamada a un método estático desde dentro 

de la misma clase 


Como todos los elementos de las clases estáticas, los métodos estáticos apare¬ 
cen sólo una vez en memoria, por lo que se debe marcar el método Main ( ) como 
static. Cuando el código NET se carga en memoria, el CLR empieza a ejecu¬ 
tar el método Main ( ) . Recuerde que sólo puede haber un método Main ( ) en 
memoria a la vez. Si una clase tiene varios métodos Main ( ). el CLR no sabría 
qué método Main ( ) c|ecutar cuando el código lo necesite. Usar la palabra cla\ e 
static en el método Main () hace que sólo haya disponible en memoria una 
copia del método Main ( ) . 


NOTA: Mediante el uso de parámetros de líneas de comandos en el 
compilador de C#, es posible incluir más de un método Main {) dentro de 
una aplicación. Esto puede ser muy útil cuando se quiere probar más de un 
método para depurar el código. 


Resumen 


C# es un lenguaje orientado a objetos y los conceptos que se emplean en los 
lenguajes orientados a objetos se pueden aplicar a C#. Las clases de C# pueden 
usar varios tipos de miembros de clase: 
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Las constantes dan nombre a un valor que no cambia en todo el código. El 
uso de constantes hace que el código sea más legible porque se pueden usar 
los nombres de las constantes en lugar de los valores literales. 

Los campos contienen el estado de las clases. Son variables que están 
asociadas a un objeto. 

Los métodos contienen el comportamiento de la clase. Son fragmentos de 
codigo con nombre que realizan una acción determinada para la clase. 

Las propiedades permiten que los fragmentos que hacen llamadas tengan 
acceso al estado de la clase. Los fragmentos que hacen la llamada acceden 
a las propiedades con la misma sintaxis object. identif ier que se 
emplea para acceder a los campos. La ventaja de las propiedades sobre los 
campos es que se puede escribir código que se ejecuta cuando se consultan 
o se asignan los valores de la propiedad. Esto permite escribir códigos de 
validación para evitar que se asignen nuevos valores a las propiedades o 
para calcular dinámicamente el valor de una propiedad que está siendo 
consultada. Se pueden implementar propiedades de lectura y escritura, 
sólo de lectura o sólo de escritura. 

Los eventos permiten que la clase informe a las aplicaciones que hacen la 
llamada cuando se produzcan determinadas acciones en su interior. Las 
aplicaciones que hacen la llamada pueden suscribirse a los eventos de clase 
y recibir avisos cuando se produzcan dichos eventos. 

Los mdizadores permiten que se acceda a la clase como si fuera una ma¬ 
triz. Las aplicaciones que hacen la llamada pueden usar la sintaxis de 
elemento de matriz de corchetes para ejecutar el código descriptor de acce¬ 
so del indizador de la clase. Los indizadores se usan cuando una clase 
contiene una colección de valores y es más lógico considerarla una matriz 
de elementos. 

Las clases pueden redefinir los operadores, como se vio en un capítulo 
anterior. Los operadores pueden ayudar a determinar cómo se comporta 
una clase cuando se usa en una expresión con un operador 

Los constructores son métodos especiales que son ejecutados cuando se 
crean objetos en la clase. Se puede definir más de un constructor, cada uno 
con una lista de parámetros diferente. También se puede definir una clase 
sin constructores. En ese caso, el compilador de C# genera un constructor 
por defecto que inicializa todos los campos del objeto con el valor cero. 

Los destructores son métodos especiales que son ejecutados cuando se 
destruyen objetos en la clase. Una clase sólo puede tener un destructor 
Debido a la interacción con el código NET y el CLR. los destructores se 
ejecutan cuando el recolector de objetos no utilizados recoge un objeto, no 
cuando el código ya no puede acceder al identificador del objeto. 
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• Las clases pueden definir tipos propios y estos tipos pueden contener de¬ 
finiciones de estructura e incluso definiciones de otras clases. Una vez 
definidos estos tipos, la clase puede usarlos de la misma forma que los 
tipos enteros en C#. 

La palabra clave this hace referencia a la instancia actual de un objeto. Se 
usa como prefijo para diferenciar a un identificador de campo de un identificado!' 
de parámetro con el mismo nombre. 

La palabra clave static advierte al compilador de C# de que todos los 
objetos de la clase comparten una sola copia de un campo o de un objeto. Por 
defecto, cada campo y cada método de una clase de C# mantiene su propia copia 
de los valores del campo en memoria. Los elementos de la clase que no usan la 
palabra clave static reciben el nombre de métodos de instancia. Los elemen¬ 
tos de clase que usan la palabra clave static reciben el nombre de métodos 
estáticos. 
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Cómo 


sobrecargar 

operadores 


C# define el comportamiento de los operadores cuando se usan en una expre¬ 
sión que contiene tipos de datos integrados en C#. Por ejemplo. C# define el 
comportamiento del operador suma calculando la suma de dos operados y ofre¬ 
ciendo la suma como el valor de la expresión. 

En C#. se puede definir el comportamiento de la mayoría de los operadores 
estándar para que puedan usarse en estructuras y clases propias. Se pueden escri¬ 
bir métodos especiales que definen el comportamiento de la clase cuando apare¬ 
cen en una expresión que usa un operador de C#. Esto permite que las clases se 
puedan emplear en expresiones que parecería más lógico que escribieran otras 
partes del código. Supongamos, por ejemplo, que estamos escribiendo una clase 
que gestiona un conjunto de archivos de una base de datos. Si algún otro fragmen¬ 
to de código tiene dos objetos de esa clase, querrá poder escribir una expresión 
que sume los archivos y los almacene en un tercer objeto. Esto parece una opera¬ 
ción de suma v parece lógico que otros fragmentos del código tengan partes 
como la siguiente: 

Records Records!; 

Records Records2; 

Records Records3; 

Records 3 = Records! + Records2; 
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La clase Records puede incluir un método que especifique cuántos objetos 
de la clase actuarán de una determinada forma cuando se usen en expresiones con 
el operador de suma. Estos métodos reciben el nombre de implementaciones de 
operadores definidas por el usuario y la operación orientada a objetos para 
definir el comportamiento de los operadores de una clase recibe el nombre de 
sobrecarga de operador. Se emplea la palabra ‘'sobrecarga" porque el cuerpo del 
código sobrecarga el significado del mismo operador y hace que se comporte de 
forma diferente, dependiendo del contexto en el que se use el operador 

Todos los métodos de sobrecarga de operadores deben declarase con las pala¬ 
bras clave static y public. 

Operadores unarios sobrecargares 


C# permite sobrecargar en sus clases y estructuras el comportamiento de estos 
operadores unarios: 

• Unario mas 

• Unario menos 

• Negación lógica 

• Operador de complemento bit a bit 

• Incremento prefijo 

• Decremento prefijo 

• La palabra clave true 

• La palabra clave false 

Cómo sobrecargar el unario más 

Si se quiere sobrecargar el unario más. el unario menos, una negación o un 
operador de complemento bit a bit en una clase o estructura, hay que definir un 
método con las siguientes características: 

• Un tipo devuelto deseado 

• La palabra clave operator 

• El operador que se quiere sobrecargar 

• Una lista de parámetros que especifique un sólo parámetro del tipo o es¬ 
tructura que contiene el método del operador sobrecargado 

Retomemos el ejemplo de la clase Point utilizada en un capítulo anterior 
Supongamos que queremos añadir un operador unario más a la clase que. cuando 
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se emplee, se asegure de que las dos coordenadas del punto sean positivas. Esto se 
implementa en el listado 10.1. 

Listado 10.1. Cómo sobrecargar el operador unario más 

class Point 

{ 

public int X; 
public int Y; 

public static Point operator + (Point RValue) 

í 

Point NewPoint = new Point ( ) ; 

i f (R V a 1 u e . X < 0 ) 

NewPoint.X = - (RValue.X) ; 

e 1 s e 

NewPoint.X - RValue.X; 

íf(RValue.Y < 0) 

NewPoint.Y = -(RValue.Y); 
e 1 s e 

NewPoint.Y = RValue.Y; 
return NewPoint; 

} 


public static void Main() 

{ 

Point MyPoint = new Point(); 

MyPoint.X = -100; 

MyPoint.Y = 200; 

System.Consolé.WriteLine(MyPoint.X); 
System. Consolé . Wr iteLme (MyPoint . Y) ; 

MyPoint - +MyPoint; 

System.Consolé.WriteLine(MyPoint.X); 
System.Consolé.WriteLine(MyPoint.Y); 



El método Main () crea un objeto de tipo Point y asigna a sus coordenadas 
iniciales los valores (100. 200). A continuación aplica el operador unario más al 
objeto v vuelve a asignar el resultado al mismo punto. Por último, escribe las 
coordenadas \ ev en la consola. En la figura 10.1 se puede ver el resultado del 
listado 10.1. Las coordenadas del punto han cambiado de (-100. 200) a (100. 
200). El código con el operador sobrecargado se ejecuta cuando se llega a la 
siguiente instrucción: 

MyPoint = +MyPoint; 
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Figura 10.1. Sobrecarga del operador unario 


Cuando se llega a esta instrucción, se ejecuta la sobrecarga del operador unario 
más para la clase Point. La expresión situada a la derecha del signo igual se 
usará como el parámetro del método. 


NOTA: La expresión situada a la derecha de un operador de asignación 
sacie ser denominada rvalue, que es la abreviatura de "valor derecho". 
La ¿xprerión a la izquierda del operador de asignación suele ser denomina¬ 
da Jvalute, que es la abreviatura de "valor izquierdo". El uso de RValue 
par* ü^>rabrar el método de sobrecarga de operadores determina que se 
está pasando el rvalue de la asignación. Esto es sólo una convención de 
► un requisito. Si k> desea, puede asignar otro nombre a los 
sr identifícador válido permitido por C#. 



Este método crea un nuevo objeto Point y a continuación examina las coor¬ 
denadas del rvalue proporcionado. Si alguno de los parámetros es negativo, 
sus valores se cambian de signo, volviéndose por tanto valores positivos, y estos 
nuevos valores positivos se asignan al nuevo punto. Los valores que no son nega¬ 
tivos se asignan al nuevo punto sin ninguna conversión. A continuación el método 
devuelve el nuevo punto. El valor devuelto por el operador se usa como Iva lúe 
para la declaración original. El tipo de retorno de las sobrecargas del operador 
para el unario más. el unario menos, la negación o los operadores de comple¬ 
mento bit a bit no tienen el mismo tipo que el rvalue. Puede ser cualquier tipo 
de C# que sea adecuado para el operador. 


Cómo sobrecargar el unario menos 

Se puede efectuar la sobrecarga del unario menos de la misma manera que se 
realiza la del unario más. 
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El listado 10.2 sobrecarga el operador menos para gestionar la clase 

Point. 


Listado 10.2. Sobrecarga del unario menos 


class Point 
{ 

public int X; 
public int Y; 

public static Point operator - (Point P.Yalue 
{ 

Point NewPoint = new Point. ( ) ; 

if jRValue.X > 0) 

NewPoint.X = -(RValue.X); 
e 1 s e 

NewPoint.X - RValue.X; 

if (RValue.Y > 0) 

NewPoint.Y - -(RValue.Y); 
e 1 s e 

NewPoint.Y = RValue.Y; 
return NewPoint; 

} 

public static void Main() 

( 

Point MyPoint = new Point(); 

MyPoint.X = -100; 

MyPoint.Y = 200; 

System.Consolé.WriteLine(MyPoint.X); 
System.Consolé.WriteLine(MyPoint.Y); 

MyPoint = -MyPoint; 

System.Consolé.WriteLine(MyPoint.X); 
System.Consolé.WriteLine (MyPoint. i) ; 


Tras definir el nuevo operador Point. simplemente se define la acción que 
debe realizar cuando se presente con una variable del tipo Point. El listado 10.2 
declara la coordenada x como -100 y la coordenada^ como 200. Estos valores se 
escriben en la consola para una verificación visual y luego se usa el operador 
sobrecargado. Después de que la aplicación de ejemplo haya realizado la resta de 
la clase Point. los valores resultantes se escriben en la ventana de la consola 
para indicar que el comportamiento ha sido el esperado. La figura 10.2 muestra el 

resultado del listado 10.2. ... 

Hasta ahora, en este capítulo hemos estudiado el unario mas y el unario me¬ 
nos. Estos operadores efectúan operaciones sobre un valor dado (por eso se lia- 
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man "unarios") Los demás operadores matemáticos básicos que pueden usarse 
sobre un valor se sobrecargan de la misma manera. 


mtm s 




LJ 


ca C:\WINDOWS\System32\cmd.eKe 

C:\>ListinylW 2.exe 
-100 
200 
100 
-200 


Figura 10.2. Sobrecarga del unario menos 


En la siguiente sección se describe un operador de otro tipo, el operador de 
complemento bit a bit. 


Cómo sobrecargar complementos bit a bit 

El operador de complemento bit a bit sólo tiene definiciones para tipos int. 
uint. long y ulong. El listado 10.3 lo sobrecarga para trabajar con la clase 

po int. 


Listado 10.3. Sobrecarga del operador de complemento bit a bit 

class Point 
{ 

public int X; 
public int Y; 

public static Point operator ~ (Point RValue) 

{ 

Point NewPoint = new Point (); 

NewPoint.X = -RValue.X; 

NewPoint.Y - -RValue.Y; 

return NewPoint; 

} 

public static void Main() 

{ 

Point MyPoint = new Point(); 
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MyPoint.X = 5; 

MyPoint.Y = 6; 

System.Consolé.WriteLine(MyPoint.X); 
System.Consolé.WriteLine(MyPoint.Y); 
MyPoint = -MyPoint; 

System.Consolé.WriteLine(MyPoint.X); 
System.Consolé.WriteLine(MyPoint.Y); 


El resultado de una operación de complemento bit a bit no se conoce con 
exactitud hasta que se ven los resultados hexadecimales de la operación. El lista¬ 
do 10.3 genera el complemento de los valores enteros 5 y 6. 

El resultado de esta operación (que aparece en la figura 10.3) es -6 y -7. 
respectivamente. 

Cuando se observan los valores hexadecimales de los valores de entrada y 
salida, es fácil deducir lo que está ocurriendo en realidad 



Figura 10.3. Sobrecarga de un complemento bit a bit 


Tabla 10.1. Valores de entrada y salida para operaciones de complemento 

bit a bit 


Input 

Output 

0x0000000000000005 

Oxfffffffffffffff A 

0x0000000000000006 

0xfffffffffffffff9 


Antes de sobrecargar un operador, es necesario entender perfectamente cómo 
funciona. En caso contrario podría obtener resultados inesperados. 
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Cómo sobrecargar el incremento prefijo 

Para sobrecargar los operadores de incremento prefijo o de decrcmento prefijo 
en una clase o estructura, se define un método con las siguientes características: 

• Un tipo devuelto que especifica el tipo de clase o estructura que contiene 
el método del operador sobrecargado 

• La palabra clave operator 

• El operador que se sobrecarga 

• Una lista de parámetros que especifica un solo parámetro del tipo de la 
clase o estructura que contiene el método del operador sobrecargado 

Por ejemplo, observe el listado 10.4. Esta clase modifica la clase Point para 
sobrecargar el operador de incremento prefijo. El operador se sobrecarga para 
aumentar en una unidad las coordenadas x e v. 

Listado 10.4. Cómo sobrecargar el incremento prefijo 

class Point 

{ 

public int X; 
public in t Y; 

public static Point operator ++ (Point RValue) 

I 

Point NewPomt - new Point () ; 

NewPomt.X - RValue. X + 1; 

NewPomt . Y = RValue. Y + 1; 

return NewPomt; 

} 


public static voicl Main () 

{ 

Point MyPoint = new Point ( ) ; 

MyPoint.X = 10 0; 

MyPoint.Y - 200; 

System.Consolé.WriteLine(MyPoint.X); 
System.Console.WriteLine(MyPoint.Y); 

MyPoint = ++MyPoint; 

System.Consolé.WriteLine(MyPoint.X); 
System.Consolé.WriteLine(MyPoint.Y); 


} 


) 


Si se compila y ejecuta el código del listado 10.4 se escribe lo siguiente en la 
consola: 
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100 
2 0 0 
101 
2 0 1 

Cómo sobrecargar el decremento prefijo 

Ahora vamos a aprender a sobrecargar el operador de decremento para ges¬ 
tionar la clase Point. El listado 10.5 contiene el listado completo para sobre¬ 
cargar el operador de forma muy parecida a como se hizo con el operador de 
incremento prefijo que acabamos de estudiar. 



Figura 10.4. Resultado de la ejecución del código compilado del listado 10 4 


Listado 10.5. Sobrecarga del operador de decremento prefijo 


class Point 
{ 

pubiic int X; 
public int Y; 

public static Point operator — (Point RValuej 
{ 

Point NewPomt = new Point () ; 

NewPoint.X = RValue.X - 1; 

NewPoint.Y = RValue.Y - 1; 
return NewPoint; 

} 


public static void Main() 

{ 

Point MyPoint = new Point ( ) ; 
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MyPoint.X = 100; 

MyPoint.Y = 200; 

System.Consolé.WriteLine(MyPoint.X); 
System.Consolé.WriteLine(MyPoint.Y); 

MyPoint = —MyPoint; 

System.Consolé.WriteLine(MyPoint.X); 
System.Consolé.WriteLine(MyPoint.Y); 



De nuevo, se pasa la coordenada x con el valor 100 y la coordenada y con el 
valor de 200. La figura 10.5 contiene el resultado de este programa después de 
que la sobrecarga del operador de decrcmento haya restado una unidad de x y 
de v. 



Figura 10.5. Sobrecarga del operador de decremento prefijo 


Cuando se sobrecargan operadores siempre hay que estar preparado para lo 
peor. Siempre hay alguna posibilidad de que los datos que se están pasando sean 
incorrectos y nos encontraremos con que la función sobrecargada no puede ges¬ 
tionar los datos. Los anteriores ejemplos no mostraban ninguna de las excepcio¬ 
nes que pueden aparecer cuando se pasan valores erróneos o inesperados. Es 
recomendable experimentar con las funciones e intentar forzar errores. 

Cómo sobrecargar los operadores true y false 

Para sobrecargar los operadores true o false en una clase o estructura hay 
que definir un método con las siguientes características: 

• Un tipo devuelto boo 1 

• La palabra clave operator 







• El operador que se sobrecarga 

• Una lista de parámetros que especifica un solo parámetro del tipo de la 
clase o estructura que contiene el método del operador sobrecargado 

El listado 10.6 es un buen ejemplo. Modifica la clase point para que devuel¬ 
va true si el punto esta en el origen o false en caso contrario. 

Listado 10.6. Sobrecarga de los operadores true y false 

class Point 
{ 

public int X; 
pubi ic int Y; 

public static bool operator true (Point RValue) 

{ 

i f ( (RValue. X == 0) && (RValue.Y == 0)) 

return true; 
retur ir f alse; 

} 


public static bool operator false (Point RValue) 
{ 

íf ( (RValue. X == 0) && (RValue.Y == 0)) 

return false; 
return true; 

} 


public static void Mam () 

{ 

Point MyPoint = new Point ( ) ; 

MyPoint.X - 100; 

MyPoint.Y = 200; 

if(MyPoint) 

System. Consolé.WriteLine("The point is at the origin .')> 
e 1 s e 

System. Consolé .WriteLine ("The point is not at the ongin. ' ) ; 

} 

} 


La sobrecarga de los operadores true y false permite que los objetos de la 
clase Point puedan usarse como expresiones booleanas. como en la instrucción 
if . Debido a que el objeto MyPoint no está en el origen, el objeto se evalúa 
como false. tal v como aparece en la figura 10.6. 

Si se sobrecarga el operador true o el operador false en una clase o es¬ 
tructura. ambos deben ser sobrecargados. Si se sobrecarga uno de los dos. pero 
no el otro, el compilador de C# emite un mensaje de error como el siguiente: 
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error CS0216: El operador 'Point.operator true(Point)' requiere 
que también se defina un operador coincidente 'false' 


d 

Figura 10.6. Sobrecarga de los operadores true y false 

Operadores binarios sobrecargabas 

Estos son los operadores binarios que se pueden sobrecargar: 

• Suma 

• Resta 

• Multiplicación 

• División 

• Resto 

• AND 

• OR 

• OR exclusivo 

• Desplazamiento a la izquierda 

• Desplazamiento a la derecha 

• Igualdad 

• Desigualdad 

• Mayor que 

• Menor que 


ca C:\WINDOWS\5ystem32\cmd.exe 


C:\>Listingí0-6.exe 

The point is not ¿\t the origin. 


USJ 
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• Mayor o igual que 

• Menor o igual que 

Si quiere sobrecargar cualquiera de los operadores binarios de una clase o 
estructura, hav que definir un método con las siguientes características: 

• Un tipo devuelto deseado 

• La palabra clave operator 

• El operador que se sobrecarga 

• Una lista de parametros que especifica dos parametros, al menos uno de 
los cuales debe ser del tipo de la clase o estructura que contiene el método 
del operador sobrecargado 

La sobrecarga de operadores binarios brinda mucha flexibilidad Pueden usar¬ 
se diferentes parámetros para los dos parámetros de la lista, lo que significa que 
se puede aplicar el operador a dos valores de diferentes tipos si se desea. También 
se puede usar cualquier tipo disponible como el valor devuelto por el operador 
sobrecargado. Si se quiere sumar un objeto y un valor de coma flotante paia 
obtener un resultado booleano. se puede escribir un método sobrecargado como el 
siguiente: 

static public bool operator + (Point MyPoint, float FloatValue) 

Se pueden definir varias sobrecargas para el mismo operador, pero solo si las 
listas de parámetros usan tipos diferentes: 

static public bool operator + (Point MyPoint, float FloatValue) 

static public bool operator + (Point MyPoint, int I nt: Valué j 

static public bool operator + (Point MyPoint, umt UlnWalue,) 

El listado 10.7 añade los operadores de igualdad v de desigualdad a la clase 
Point. El operador devuelve resultados booleanos que devuelven truc si los 
dos objetos Point tienen las mismas coordenadas; en caso contrario, devuelven 

faise. 

Listado 10.7. Sobrecarga de los operadores de igualdad y desigualdad 

class Point 

{ 

public int X; 
public int Y; 

public static bool operator == (Point Pomtl, Point Point¿.) 

{ 

if (Point1.X ! = Point2.X) 
return faise; 
i f(Point1. Y != Point2. Y) 
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return false; 
return true; 

} 


public override bool Equals(object o) 

{ 

return true; 

} 

public override int GetHashCode() 

í 

return 0; 

} 

public static bool operator != (Point Pointl, Point Point2) 

{ 

if(Point1.X != Point2.X) 
return true; 

if(Point2.Y != Point2.Y) 
return true; 
return false; 


public static void Main() 

{ 

Point MyFirstPoint = new Point(); 

Point MySecondPoint = new Point(); 

Point MyThirdPoint = new Point(); 

MyFirstPoint.X = 100; 

MyFirstPoint.Y = 200; 

MySecondPoint.X = 500; 

MySecondPoint.Y - 750; 

MyThirdPoint.X = 100; 

MyThirdPoint . Y = 200; 

if(MyFirstPoint = = MySecondPoint) 

System.Consolé.WriteLine("MyFirstPoint and 
MySecondPoint are at the same coordinates."); 
e 1 s e 

System.Consolé.WriteLine("MyFirstPoint and 
MySecondPoint are not at the same coordinates.”) ; 

if(MyFirstPoint == MyThirdPoint) 

System.Consolé.WriteLine("MyFirstPoint and MyThirdPoint 
are at the same coordinates."); 
e 1 s e 

System.Consolé.WriteLine("MyFirstPoint and MyThirdPoint 
are not at the same coordinates.") ; 
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El método Main ( ) define tres puntos: 

• MyFirstPoint. con coordenadas (100, 200) 

• MySecondPoint. con coordenadas (500. 750) 

• MyThirdPoint, con coordenadas (100. 200) 

A continuación el método usa el operador de igualdad para determinar si los 
puntos MyFirs tPoint v MySecondPoint hacen referencia a la mismas 
coordenadas. Entonces usa el operador de igualdad para determinar si los puntos 
MyFirst Point y MySecondPoint hacen referencia a las mismas coordena¬ 
das. En la figura 10.7 se muestra el resultado que se obtiene si se compila y 
ejecuta el codigo del listado 10.7. 



Los siguientes pares de operadores deben ser sobrecargados conjuntamente. 

• Igualdad y desigualdad 

• Menor y mayor que 

• Menor o igual que y mayor o igual que 

Si se sobrecarga uno de esto pares pero no el otro, el compilador de C# emite 
un mensaje cómo el siguiente: 

error CS0216: El operador ' Point . ope rator —(Point, Point) ' 
requiere que también se defina un operador coincidente !- 

Operadores de conversión sobrecargares 

También se pueden escribir métodos de sobrecarga de operadores que convier¬ 
tan un tipo en otro. El método de sobrecarga también puede definir si el compilador 
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de C# debe tratar la conversión como implícita o explícita. Si quiere definir un 
nuevo operador de conversión en una clase o estructura, debe definir un método 
con las siguientes características: 

• La palabra clave implicit si la conversión va a considerarse una con¬ 
versión implícita o la palabra clave explici t si la conversión va a con¬ 
siderarse una conversión explícita 

• La palabra clave operator 

• Un tipo que especifica el tipo al que se va a hacer la conversión 

• Una lista de parametros que especifica el tipo original de la conversión 

F1 listado IO S define una conversión implícita de un objeto de la clase Poinr 
a doubje. El tipo doble especifica la distancia desde el origen hasta el punto, 
usando el teorema de Pitagoras. 

Listado 10.8. Cómo definir una conversión implícita 

c 1 a s s P o i n t 
í 

public mt X; 
publie int Y; 

public static implicit operator double(Point RValue) 

f 

double Distanee; 
clouble Sum; 

Sum = (RValue.X * RValue.X) + (RValue.Y * RValue.Y) ; 

Distancie = System.Math. Sqrt (Sum) ; 
r e t u r n D i s t. a n c e ; 

} 


public stat.i c v o i el Main ( ). 


el ou b 1 e ti i s t a r. c e ; 

P oi nt My Po i nt = new Po i nt (1$ 


MyPoint. .7 = lUÜ; 

MyPoint. .Y = 2 0 U ; 

Distan c o = M y P o int; 

3 y s t. e m. C o 11 s ole.Wr .i teLine ÍDistance) ; 


NOTA: .NET Framework define el método System.Math. Sqrt () que 
calcula la raíz cuadrada del parámetro proporcionado. El método es estáti¬ 
co, por lo que se le puede llamar aunque no se tenga un objeto del tipo 
System.Math para llamarlo. 


252 




El método Main ( ) declara un objeto del tipo Point v asigna a sus coorde¬ 
nadas los valores (100. 200). A continuación asigna el objeto a una variable de 
tipo double. lo que está permitido porque la clase Point define un operador de 
conversión que convierte un objeto Point a doble. C omo el operador de conver¬ 
sión esta definido como una conversión implícita, no es necesaria una conversión 
explícita. A continuación el método Main ( ) escribe el valor de double con\cuti¬ 
do en la consola. La figura 10.8 muestra el resultado del listado 10.8. 

xjl 


y 

Figura 10.8. Definición de una conversión implícita 

Operadores que no pueden sobrecargarse 

CU no permite redefinir el comportamiento de los operadores de la siguiente 
lista. Esto se hace principalmente en beneficio de la simplicidad. Eos progiama¬ 
dores de CU quieren que estos operadores no dejen de ser sencillos y que siem¬ 
pre realicen la misma función; por tanto, no esta permitido sobrecargarlos. 

• Asignación 

• AND condicional 

• OR condicional 

• Condicional 

• Las palabras clave new. typeof. si. r.eof e is 


c=v C:\WINDOWS\System32\cmd.exe 

C:\>Listingl0-8.exe 
223,606797749979 

C:\>_ 


Resumen 

C# permite personalizar el comportamiento de varios de los operadores inte¬ 
grados. Las clases y las estructuras pueden incluir métodos llamados métodos de 
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sobrecarga de operador que definen el comportamiento de un operador cuan¬ 
do aparece en una expresión con la clase o estructura. 

Para sobrecargar los operadores unario más. unario menos, de negación o de 
complemento bit a bit en una clase o estructura, hay que definir un método con un 
tipo devuelto deseado, el operador que se está sobrecargando y un solo parámetro 
del tipo de la clase o estructura que contiene el método de operador sobrecargado. 

Para sobrecargar los operadores de incremento o decrcmento prefijo en una 
clase o estructura, hay que definir un método con un tipo de devolución que 
especifica el tipo de clase o estructura que contiene el método del operador sobre¬ 
cargado. También es necesario definir el operador que se está sobrecargando y un 
solo parámetro del tipo de clase o estructura que contiene el método del operador 
sobrecargado. 

Para sobrecargar los operadores true o false en una clase o estructura, 
hay que definir un método con un tipo de devolución booleano y un solo parametro 
del tipo de la clase o estructura que contiene el método de operador sobrecargado. 

Para sobrecargar cualquiera de los operadores binarios en una clase o estruc¬ 
tura. hay que definir un método con un tipo de devolución, el operador que se esta 
sobrecargando y dos parámetros. Al menos uno de los dos parámetros debe ser del 
tipo de clase o estructura que contiene el método del operador sobrecargado. 

También se pueden definir nuevas conversiones para las clases o estructuras 
Se especifica si la conversión se considerara un operador implícito o explícito, f 1 
método del operador de conversión especifica el tipo de la variable que se convier¬ 
te v el tipo al que debe ser convertida. 
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Herencia 
de clase 


Los programas mas simples de C# pueden usar una o dos clases. Sin embargo, 
probablemente se necesiten varias clases en los programas más grandes. Muchas 
de estas clases pueden tener campos o métodos similares y seria lógico compartir 
el código común entre el conjunto de clases. 

C# incluye el concepto orientado a objetos de herencia . que permite que una 
clase adopte eodigo de otras clases. Las clases de C# pueden derivarse de las 
clases primarias y las instrucciones heredadas pueden ser usadas en otras clases. 

La herencia se usa en el desarrollo de software orientado a objetos para 
reutilizar los códigos mas comunes Observe, por ejemplo, los cuadros de lista de 
selección múltiple y de selección simple de Windows. Estos cuadros de lista tie¬ 
nen diferentes funcionalidades; uno permite que se seleccionen varios elementos 
v el otro lo impide, pero también tienen muchas similitudes. Tienen el mismo 
aspecto, se comportan de la misma forma cuando el usuario se desplaza por la 
lista y usan el mismo color para marcar un elemento seleccionado. Si hubiera que 
escribir estos dos cuadros de lista como clases de C#. se podrían escribir por 
separado, sin que uno conozca la existencia del otro. Sin embargo, eso sería un 
desperdicio. La mayor parte del código seguramente sea idéntico. Sería más ló¬ 
gico escribir una clase que contuviera el código común y disponer de clases deri¬ 
vadas de la clase de código común y que implementasen las diferentes 
funcionalidades. Se puede escribir una clase llamada ListBox para que. por 
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ejemplo, contenga el código común y. a continuación, escribir una clase de C# 
llamada SingleSelectionListBox que herede de ListBox y proporcio¬ 
ne el código único al cuadro de lista de selección simple. También se puede 
escribir una clase de C# llamada MultipleSelectionListBox que tam¬ 
bién herede de ListBox pero que proporcione el código único al cuadro de lista 
de selección simple. Otra de las ventajas consiste en que, si encuentra un error en 
el cuadro de lista, se le puede seguir fácilmente la pista hasta el error en el código 
común. Si se puede reparar el error en el código común, al volver a compilar el 
programa se repararán esos errores en las clases de cuadros de lista de selección 
múltiple y selección simple. Basta reparar un error para solucionar el problema en 
las dos clases. En terminología orientada a objetos, se habla de herencia en térmi¬ 
nos de clase base y clase derivada. La clase de la que se hereda recibe el nombre 
de clase base y la clase que hereda de la clase base recibe el nombre de clase 
derivada. En el ejemplo de los cuadros de lista, la clase ListBox es la clase base 
y las clases SingleSelect ionListBox y Mult ipleSelect ionListBox 
son las clases derivadas. 

Cómo compilar con clases múltiples 

Trabajar con herencias en C# significa que se va a trabajar con más de una 
clase de C#. C# no es muy estricto respecto a cómo se rclacionarl estas clases con 
los archivos fuente. Se pueden poner todas las clases en un solo archivo fuente o 
se puede poner cada clase en un archivo fuente diferente. 

Obviamente, excepto en los programas más pequeños, implementar todas las 
clases en un solo archivo no es un buen modo de organizar el código. Ha> que 
tener en cuenta que todas las clases se recompüan cada vez que se hace un cambio 
en alguna parte del programa. Para compilar un programa que usa archivos fuen¬ 
te separados desde una línea de comandos, tan sólo hay que escribir cada archivo 
después del nombre del compilador, como se ve en el ejemplo: 

esc filel.es file2.es file3.es 

Por defecto, el compilador de C# da al ejecutable resultante el nombre del pri¬ 
mer archivo fuente. La anterior línea de comandos produce un ejecutable llamado 
file 1 exe. Se puede usar el argumento /out para cambiar el nombre del archivo: 

esc /out:myapp.exe filel.es file2.es file3.es 

Esta linca de comandos del compilador genera un ejecutable llamado 
myapp.exe. 


NOTA i Ufta, y sólo iina, de sus clases debe especificar un método estáti 
ed Máin (). 
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Cómo especificar una clase base en C# 

Volvamos al ejemplo de la clase Point para ver cómo funciona la herencia 
en C#. Supongamos que hemos designado una clase llamada Point2D. que 
describe un punto en un espacio bidimensional con las coordenadas X e Y: 

class Point2D 

{ 

public int X; 

public int Y; 

// mas código 

} 

Ahora supongamos que queremos trabajar con puntos en un espacio 
tridimensional, pero manteniendo la clase Point2D. La herencia nos permite 
crear una nueva clase que mantiene todo el código de la clase Point2D y le 
añade una coordenada Z 

Para nombrar la clase base de C# se escribe el nombre de la clase derivada 
seguido por dos puntos y del nombre de la clase base. A continuación, se incluye 
un ejemplo de cómo se derivaría la clase Point3D a partir de la clase Point2D: 

class Point3D : Point2D 

{ 

public int Z; 

// código para la clase Point3D 

} 

Dependiendo de las reglas de ámbito de la clase base, todos los campos y 
propiedades de la clase base (Point2D) pueden ser empleadas en la clase deri¬ 
vada (Point3D). Por ejemplo, cuando una clase se deriva de una clase base, el 
código de la clase derivada puede acceder a los campos y propiedades de la clase 
base, si el ámbito lo permite. 

Sólo se puede escribir una clase cuando una clase se hereda de otra. Algunos 
lenguajes orientados a objetos, como C++. permiten especificar más de una clase 
base para una clase derivada. Este concepto recibe el nombre de herencia múlti¬ 
ple. C# admite la herencia simple, pero no la múltiple. En el apartado dedicado a 
la contención se explica una técnica para simular herencias múltiples en C#. 

El listado 11.1 enseña a usar las clases Point3D y Point2D juntas. 

Listado 11.1. Cómo derivar Point3D a partir de Pomt2D 

class Point2D 

{ 

public int X; 

public int Y; 

} 


class Point3D : Point2D 
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public int Z; 


class MyMainClass 
{ 

public static void Main() 

í 

Po i n 12 D My2 DPo i nt = new Pomt2D () ; 
Po.int3D My3DPoint = new Point3D() ; 

My2DPoint.X = 100; 

My2DPoint.Y - 200; 

M y 3 D P oin t.X - 15 0; 

My3DPoint.Y - 2 50 ; 

My3DPoint.Z = 350; 

} 


El método Main ( ) crea un objeto Poi.nt2D y otro Point3D. El objeto 
Poi nt3D tiene campos para las coordenadas X. Y y Z. aunque la declaración de 
Point3D sólo declare un campo llamado Z. Los campos X c Y se heredan de la 
clase base PointPD y pueden ser usados exactamente igual que si se hubieran 
declarado directamente en la clase Point3D. 


Ámbito 

Al diseñar la estructura de la herencia de clase, puede decidir que miembros de 
la clase base no deben ser visibles para las clases derivadas o para los demás 
programadores Por ejemplo, se puede escribir un método en una clase base que 
ayude a calcular un valor Si ese cálculo no es de utilidad en una clase derivada, 
se puede evitar que la clase deriv ada llame al método. 

En terminología de la programación, la v isibilidad de una variable o método se 
conoce como su ámbito. Algunas variables o métodos pueden ser declaradas 
como de ámbito publico, otras pueden ser declaradas como de ámbito privado y 
otras pueden estar entre estos dos casos. 

C# define cinco palabras clave que permiten definir el ámbito de cualquier 
miembro (variable o método) de una clase. El ámbito de un miembro afecta a su 
visibilidad para las clases derivadas y el código que crea las instancias de la 
clase. Estas palabras clave, resaltadas en la siguiente lista, se colocan antes de 
cualquier otra palabra clav e en una declaración de miembro. 

• Los miembros marcados como public son visibles para las clases deri¬ 
vadas y para el código que crea los objetos de la clase. Hasta ahora hemos 
usado public. 
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• Los miembros marcados como prívate sólo son visibles para la clase 
en la que se definen. Los miembros privados no son accesibles desde las 
clases derivadas ni desde el código que crea los objetos de la clase. 

• Los miembros marcados como protected solo son visibles para la cla¬ 
se en la que se definen o desde las clases derivadas de esa clase. No se 
puede acceder a los miembros protegidos desde el código que crea los 
objetos de su clase. 

• Los miembros marcados como internal son visibles para cualquier 
código en el mismo archivo binario, pero no son visibles para otros archi¬ 
vos binarios Recuerde que NET Framework acepta el concepto de ensam¬ 
blados. que son bibliotecas de código ya compiladas que pueden ser usadas 
por aplicaciones externas. Si se escribe una clase en C# y se compila la 
clase para obtener un ensamblado, cualquier fragmento de código del en¬ 
samblado podrá acceder a los miembros de clase interna. Sin embargo, si 
otro fragmento de código usa ese ensamblado, no tendrá acceso al miem¬ 
bro. aunque derive una clase de la clase del ensamblado. 

• Los miembros marcados como protected internal son visibles 
para todo el código incluido en el mismo archivo binario y para las clases 
externas que se deriven de su clase. Si se escribe una clase en C# y se 
compila la clase para obtener un ensamblado, cualquier fragmento de códi¬ 
go del ensamblado puede acceder a los miembros de clase interna. Si otro 
fragmento de codigo externo usa el ensamblado y deriva una clase de la 
clase del ensamblado, el miembro interno protegido sera accesible para la 
clase derivada. Sin embargo, el código que trabaja con los objetos de la 
clase base no tendrá acceso al miembro. 

C# permite especificar un miembro de clase sin especificar ninguna palabra 
clave de ámbito. 

Si se declara un miembro de clase sin especificar ninguna palabra clave de 
ámbito, al miembro se le asigna por defecto accesibilidad privada Los miembros 
que se han declarado sin usar ninguna palabra clave de ámbito pueden usarse en 
otras partes de la clase, pero no pueden ser usados por clases derivadas ni por 
codigo que use objetos de la clase. 

Cómo reutilizar identificadores de miembros 
en las clases derivadas 


C# permite reutilizar identificadores de clase base en las clases derivadas, 
pero el compilador de C# emite un aviso cuando lo detecta. Preste atención al 
codigo del listado 1 1.2. 
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Listado 11.2. Cómo reutilizar identificadores de clase base 

class Point2D 

{ 

public int X; 
public int Y; 

} 

class Pomt3D : Point2D 

{ 

public int X; 
public int Y; 
public int Z; 

} 

class MyMainClass 

{ 

public static void Main() 

{ 

Point2D My2DPoint = new Point2D() ; 

Point3D My3DPoint = new Point3D(); 

My2 DPoint.X - 100; 

My2DPoint.Y - 200; 

My3 DPoint.X = 150; 

My3DPoint.Y = 250 ; 

My3DPoint.Z = 350; 



La clase derivada Point3D define los campos X e Y que coinciden con los 
identificadores usados en la clase base Point2D. El compilador de C# emite las 
siguientes advertencias cuando se compila este código: 

warning CS0108: La palabra clave new es necesaria en 
'Point3D.X r porque oculta el miembro heredado 'Point2D.X' 
warning CS0108: La palabra clave new es necesaria en 
'Point3D.Y f porque oculta el miembro heredado 'Point2D.Y' 

El compilador de C# emite avisos porque los identificadores de la clase deriva¬ 
da ocultan las definiciones que usan el mismo identificador en la clase base. Si se 
quieren reutilizar los nombres, pero no que el compilador emita avisos, se puede 
usar el operador new al reutilizar los identificadores en la clase derivada. El 
codigo del listado 1 1.3 compila sin emitir avisos. 

Listado 11.3. Cómo usar new para reutilizar identificadores de clase 

class Pomt2D 

{ 

public int X; 
public int Y; 




} 

class Point3D : Point2D 
{ 

new public int X; 
new public int Y; 
public int Z; 

} 


class MyMainClass 
{ 

public static void Main{) 

{ 

Point2D My2DPoint = new Point2D(); 
Point3D My3DPoint = new Point3D(); 

My2DPoint.X = 100; 

My2 DPoint.Y = 200 ; 

My3 DPoint.X = 150; 

My3 DPoint.Y = 250; 

My3DPoint.Z = 350; 

} 


Cómo trabajar con métodos heredados 


C# permite que los métodos de la clase base y de las clases derivadas se 
relacionen de varios modos. C# permite los siguientes métodos: 

• Métodos virtuales y de reemplazo 

• Métodos abstractos 

Métodos virtuales y de reemplazo 

Quizás quiera que una clase derivada cambie la implementación de un método 
en una clase base, pero manteniendo el nombre del método. Suponga, por ejem¬ 
plo. que la clase Point2D implementa un método llamado PrintToConsole (). 
que escribe las coordenadas X e Y del punto en la consola. Quizás también quiera 
que la clase derivada Point3D proporcione su propia implementación de 
PrintToConsole ( ) . Sin embargo, no puede usar el método PrintToCon¬ 
sole ( ) de la clase Point2D. porque esa implementación sólo funciona con las 
coordenadas X e Y y la clase Point3D también tiene una coordenada Z. La 
clase Point3D debe facilitar su propia implementación del mismo método 
PrintToConsole ( ) . Los nombres de métodos pueden reutilizarse en clases 
derivadas si el método de clase base permite que el método pueda volver a ser 
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implemcntado. La operación de reimplementar un método de clase base en una 
clase derivada recibe el nombre d c reemplazar el método de clase base. Al reem¬ 
plazar un método de clase base en C# hay que tener en cuenta los dos requisitos: 

• El método de clase base debe declararse con la palabra clave virtual. 

• El método de la clase derivada debe declararse con la palabra clave 

ove r r i de. 

Los métodos de clase base que usan la palabra clave virtual reciben el 
nombre de métodos virtuales y los de clase base que usan la palabra clave 
overr ide reciben el nombre de métodos de reemplazo. El listado 1 1.4 demues¬ 
tra cómo puede implemcntarse el método PrintToConsole ( ) para las clase 

Point2D y Point3D. 

Listado 11.4. Cómo reemplazar métodos virtuales 

class P o i n 12 D 
{ 

pub1ic int X; 
public int Y; 

public virtual void PrintToConsole() 

{ 

System.Consolé.WriteLine("({0} , {1})", X, Y); 

} 

} 

class P oin t 3 D : P oin 12 D 
í 

public int Z; 

public override void PrintToConsole() 

{ 

System.Consolé.WriteLine(" ({0} , {1} , { 2 } ) " , X, Y , Z } ; 

} 

} 

class MyMainClass 
{ 

public static void Main() 

{ 

Point2D MyBDPoint - new Point2D() ; 

Point3D MyBDPoint - new Point.3D(); 

My2 DPoint.X - 100; 

MyBDPoint . Y = 200 ; 

MyBDPoint.X - 150; 

My 3 D P oin t.Y = 2 5 0; 

MyBDPoint.Z - 350; 





My2DPoint.PrintToConsole (); 
My3DPoint.PrintToConsole ( ) ; 


} 

} 


NOTA: La sintaxis de las llamadas WriteLine () hechas en el listado 
11.4 es diferente de la sintaxis u$a4s con afite?Í0ri«|a<jL LpS números entre 
llaves de la cadena son comodines. Los valores de los otros parámetros se 
escriben en la consola en lugar del comodín. El comodín {01 es reemplaza- 
do por el valor del primer parámetro, el comodín {1} es reemplazado por el 
valor del segundo parámetro y así sucesivamente. 


El listado 1 1.4 escribe esto en la consola: 

( 100 , 200 ) 

(150, 250, 350) 

No se puede reemplazar un método de clase base a menos que use la palabra 
clave virtual. Si intenta hacerlo sin usar la palabra clave, el compilador de C# 
emite el siguiente error: 

error CS0506: ' Point3D.PrintToConsole() ' : no se puede 

reemplazar el miembro heredado 'Point2D.PrintToConsole() ' 
porque no está marcado como virtual, abstract u override 

Sin embargo, está permitido reemplazar un método override. Si. por algu¬ 
na extraña razón, se quiere implementar una clase Point4D y derivarla de 
Point 3D. es posible reemplazar el método de PointSD PrintToConsole ( ) . 


Polimorfismo 

El concepto de reemplazo de métodos lleva al concepto de polimorfismo. Cuando 
reemplazamos un método, queremos llamar al método apropiado desde cualquier 
método que llame a este método reemplazado. 

El listado 11.5 presenta este concepto en acción. Se ha añadido a Point2D 
un método UsePr intToConsole ( ) que llama al método virtual 
PrintToConsole ( ) . Point3D hereda este método de Point2D. Cuando 
se llama a PrintToConsole ( ) en esta función, se quiere llamar a la versión 
que pertenece a la clase apropiada. En otras palabras, en el método 
UsePr i ntToConsole ( ) que pertenece a la clase Point2D. se pretende lla¬ 
mar al método PrintToConsole ( ) que pertenece a la clase Poi nt2D. En el 
método UsePr intToConsole ( ) que pertenece a la clase Point3D. se pre¬ 
tende llamar al método reemplazado PrintToConsole ( ) que pertenece a la 
clase Point3D. Como el método PrintToConsole ( ) fue declarado como 
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un método virtual, la detección de la versión que debe ejecutarse tiene lugar 
automáticamente. El listado 1 1.5 escribe lo siguiente en la consola: 


( 100 , 200 ) 

(150, 250, 350) 

Listado 11.5. Polimorfismo 

class Point2D 

{ 

public ínt X; 
public int Y; 

public virtual void PrintToConsole{) 

{ 

System.Consolé.WriteLine("({ 0 } , {!})", X, Y); 

} 

public void UsePrmtToConsole() 

{ 

PrintToConsole(); 

} 


class Point3D : Point2D 

{ 

public int Z; 

public override void PrintToConsole() 

{ 

System.Consolé.WriteLine(" ({0}, {1}, {2})", X, 

} 


class MyMainClass 

{ 

public static void Main() 

{ 

Point2D My2DPoint = new Point2D(); 
Point3D My3DPoint = new Point3D(); 


My2 DPoint.X = 100; 

My2 DPoint.Y = 200 ; 

My3DPoint.X = 150; 

My3 DPoint.Y = 250; 

My3 DPoint.Z - 350 ; 

My2DPoint.UsePrintToConsole(); 
My3DPoint.UsePrintToConsole(); 


Y, Z) ; 
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Métodos abstractos 


Algunas clases base pueden no ser capaces de proporcionar la implementación 
de un método. pero puede que queremos que las clases derivadas proporcionen 
una implementación. Supongamos, por ejemplo, que estamos escribiendo en C# 
una aplicación de geometría y escribimos clases llamadas Square y Circle. 
Decidiremos las funciones comunes que usará cada forma de la aplicación y por 
lo tanto implementamos una clase base llamada Shape y derivamos las clases 
Square y Circle de Shape: 


Class Shape 
{ 

} 


class Circle : Shape 
{ 

} 


class Square : Shape 
{ 

} 

Ahora supongamos que decidimos que todas las formas deben ser capaces de 
calcular su área, de modo que escribimos un método llamado GetArea ( ) . El 
problema de escribir ese código en la clase base es que la clase base no tiene 
suficiente información para calcular un área. Cada forma calcula su área usando 
una fórmula diferente. 

Lo que podemos hacer es definir un método abstracto en la clase base Shape. 
Los métodos abstractos no proporcionan una implementación propia sino que 
proporcionan una firma de método que las clases derivadas deben implementai. 
Los métodos abstractos dicen "Yo no se implementar este método, pero mi clase 
derivada lo hará, de modo que asegúrese de que la implementen con los parámetros 
v el código devuelto que yo especifico." Los siguientes fragmentos demuestran 
cómo declarar un método abstracto en la clase Shape. 

abstract class Shape 
{ 

public abstract double GetArea(); 

} 


NOTA: Las clases abstractas usan la palabra clave abstract. No tienen 
cuerpo de método; en su lugar hay un punto y coma después de la lista de 
parámetros. 


Las clases abstractas también son. por definición, métodos virtuales y debe 
usarse la palabra clave override para reemplazarlos por clases derivadas: 
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class Square : Shape 


{ 

public override double GetArea () 

{ 

// implemente el cálculo del área 



Las clases que contienen al menos un método abstracto reciben el nombre de 
clases abstractas y deben incluir la palabra clave abstract antes de la palabra 
clave de la clase. Si no se incluye la palabra clave abstract al definir la clase 
se obtendrá un error del compilador de C#: 

error CS0513: ' Shape.GetArea ()' es abstract pero está incluida 

en la clase nonabstract 'Shape' 

El compilador de C# no permite crear objetos a partir de clases abstractas. Si 
se intenta el compilador de C# emite un error: 

error CS0144: No se puede crear una instancia de la clase o 
interfaz abstracta 'Shape' 

Las clases abstractas suelen usarse para crear una clase base común a un 
conjunto de clases. Esto permite usar el polimorfismo al almacenar clases deriva¬ 
das en algún tipo de colección, como se vio en un capítulo anterior. 

Clases base: Cómo trabajar con propiedades 
e indizadores heredados 


En C#. se pueden marcar como virtual, override o abstract. pro¬ 
piedades e indizadores de clases base y derivadas, igual que si fueran métodos. 



Las propiedades virtual y override y los indizadores funcionan como 
las propiedades virtual y override. Las propiedades y los indizadores pue¬ 
den marcarse como virtuales en una clase base y como reemplazados en una clase 
derivada. Las clases base pueden definir propiedades e indizadores. que no tienen 
implementación propia. Las clases base que contienen al menos una propiedad 
abstracta o un indizador deben ser marcadas como si fueran una clase abstracta. 
Las propiedades abstractas y los indizadores deben ser reemplazados en una clase 
base. 
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Cómo usar la palabra clave base 

C# proporciona la palabra clave base para que las clases derivadas puedan 
acceder a las funciones de su clase base. Se puede usar la palabra clave base 
para llamar a un constructor de clase base cuando se crea un objeto de una clase 
derivada. Para llamar a un constructor de clase base hay que colocar después del 
constructor de la clase derivada dos puntos, la palabra clave base y a continua¬ 
ción los parámetros que se van a pasar a la clase base. El listado 1 1.6 demuestra 
el funcionamiento de todo esto. Añade constructores para las clases Point2D y 
Point3D y el constructor Point3D llama al constructor de su clase base. 

Listado 11.6. Cómo llamar a constructores de clase base 

class Point2D 
{ 

public int X; 
public int Y; 

public Point2D(int X, int Y) 

{ 

t h i s . X = X ; 
this.Y = Y; 

} 


public virtual void PrintToConsole() 

{ 

System. Consolé .WnteLine ("( { 0 } , {1})", X, Y); 

} 


class Point3D : Point2D 
{ 

public int Z; 

public Point3D(int X, int Y, int Z) : base(X, Y) 

{ 

t h i s . Z = Z ; 

} 

public override void PrintToConsole() 

{ 

System. Consolé .WnteLine ( " ({ 0 } , {1}, { 2 } ) " , X, Y, Z); 

} 


class MyMainClass 
{ 

public static void Main() 

{ 

Point2D My2DPoint - new Point2D(100, 200); 
Point3D My3DPomt = new Point3D(150, 250, 350); 
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My2DPoint.PrintToConsole () ; 

My3DPoint.PrintToConsole(); 

} 

} 

El constructor de la clase Point2D establece los campos X e Y de la clase 
mediante los dos enteros que se pasan al constructor. El constructor de la clase 
Point3D admite tres parámetros. Los primeros dos parámetros se pasan al cons¬ 
tructor de la clase base usando la palabra clave base y el tercero se usa para 
establecer el valor del campo Z de la clase derivada. 

Cómo acceder a campos de clase base 
con la palabra clave base 

También se puede usar la palabra clave base para acceder a miembros de la 
clase base. Para trabajar con un miembro de clase base en la clase derivada, hay 
que anteponer al nombre del miembro la palabra clave base y un punto. Se 
puede acceder a los campos de la clase base mediante la siguiente sintaxis: 

base.X - 100; 

También se puede invocar a métodos de clase base con esta otra sintaxis: 

base.PnntToConsole () ; 


Clases selladas 


Si no quiere que se derive codigo de una determinada clase, puede marcar la 
clase con la palabra clave sealed. No se puede derivar una clase de una clase 
sellada. Se puede especificar una clase sellada escribiendo la palabra clav e sealed 
antes de la palabra clave class. como en este ejemplo: 

sealed class MySealedClass 

Si se intenta derivar una clase de una clase derivada, el compilador de C# 
emite un error: 

error C S 0 5 0 9 : ' P o i n t. 3 D' : no se puede heredar de la clase 

sealed ' P o i n 12 D' 


Contención y delegación 

Si la herencia es una relación ES-UN. la contención es una relación TIENE- 
UN. Un gato de Birmania ES UN gato (por lo que puede heredar la clase 
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DcBirmania de la clase genérica Gato); pero un Coche TIENE 4 ruedas (por lo 
que la clase Coche puede tener cuatro objetos Rueda). El aspecto más interesante 
de la contención es que se puede emplear como sustituto de la herencia. El princi¬ 
pal inconveniente de usar la contención en lugar de la herencia es que se pierden 
las ventajas del polimorfismo. Sin embargo, se obtienen los beneficios de la 
reutilización del código. 

En C#. hav dos casos comunes en los que prácticamente sólo se puede emplear 
la contención v no la herencia: cuando se trabaja con herencias múltiples y cuan¬ 
do se trabaja con clases selladas. A continuación se incluye un ejemplo que mues¬ 
tra cómo funciona esta técnica. Además, verá trabajar al polimorfismo. 

Supongamos que tenemos una clase Alarmelock y una clase Radio como 
las que aparecen en el siguiente fragmento y queremos crear una clase 
ClockRadio que combine estas dos clases. Si C# admitiese herencias múlti¬ 
ples. se podría hacer que ClockRadio heredase de las clases AlarmCIock y 
Radio. A continuación se podria añadir una variable booleana radioAlarm 
que determine si se activa la alarma o la radio y que reemplace SoundAlarm ( ) 
para usar esta variable. Por desgracia. C# no admite herencias múltiples. Por 
suerte, se puede emplear la contención en lugar de la herencia y obtener todas las 
ventajas de la reutilización de código. Observe cómo funciona, paso a paso; 

class Radio 
{ 

protected bool on_off; 

public void On () 

í 

íf { !on_off) Consolé.WriteLine("Radio is now on!") ; 
on_off = true; 

} 


public void Off() 

{ 

if ( on of f) Consolé.WriteLine (" Rad io i s now off ! " ) ; 
on_off = false; 

} 


class AlarmClock 
{ 

private int currentTime; 
private int alarmTime; 

prívate void SoundAlarmO 

{ 

Consolé.WriteLine ( "Buzz!") ; 

} 


public void Run() 
{ 
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for (int currTime = 0; currTime < 43200; currTime++) 

{ 

SetCurrentTime(currTime); 

if (GetCurrentTime() == GetAlarmTime() ) 

{ 

Consolé.WriteLine("Current Time = {0}! M , currentTime); 

S oundAlarm() ; 
break; 

} 



public int GetCurrentTime() 
{ 

return currentTime; 

} 


public void SetCurrentTime(int aTime) 
{ 

currentTime = aTime; 

} 


public int GetAlarmTime() 

{ 

return alarmTime; 

} 

public void SetAlarmTime(int aTime) 
{ 

alarmTime = aTime; 

} 


Como queremos reemplazar el método SoundAlarm( ) de AlarmClock. 
es recomendable hacer que ClockRadio herede de AlarmClock. Esto re¬ 
quiere un pequeño cambio en la implementación de AlarmClock. Sin embargo, 
a cambio se consiguen todos los beneficios del polimorfismo. Una vez que se ha 
seleccionado una clase base, no podemos heredar de Radio. En lugar de heredar, 
crearemos una variable de miembro privada Radio dentro de la clase 
ClockRadio. Creamos el miembro privado en el constructor ClockRadio v 
delegamos el trabajo de los métodos RadioOn {) y RadioOf f () en este miembro 
privado. Cada vez que la implementación de la clase Radio cambia (por ejem¬ 
plo. para reparar algún error), la clase AlarmClock incorporará automáticamente 
estos cambios. Un inconveniente del enfoque contención/delegación es que para 
añadir una nueva funcionalidad de la clase contenida (por ejemplo, añadir nuevos 
métodos para ajustar el volumen) es necesario hacer cambios en la clase conteni¬ 
da para delegar esta nueva funcionalidad en el miembro privado. 

class ClockRadio : AlarmClock 

í 
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prívate Radio radio; 

// Declarar otras variables de miembro... 

public ClockRadio() 

{ 

radio = new Radio() ; 

// Establecer el valor de otras variables de miembro 

} 


//- Delegar en Radio - 

public void RadioOn() 

{ 

radio.On ( ) ; 

} 


public void RadioOff() 

{ 

radio.Off(); 


Ya hemos implementado completamente la funcionalidad de la radio mediante 
el patrón contención/delegación. Es hora de añadir la funcionalidad AlarmClock. 
En primer lugar, se añade una variable privada radioAlarm que determina si 
debe sonar la radio o si debe sonar el timbre cuando se dispare la alarma: 

Class ClockRadio : AlarmClock 

{ 

prívate bool radioAlarm; 

// Declarar otras variables miembro... 
public ClockRadi o ( ) 

{ 

radioAlarm - false; 

// Establecer el valor de otras variables miembro... 

} 


II _ Nueva funcionalidad ClockRadio 

public void Set Radio Al arm (bool useRadio.) 

{ 

radioAlarm = useRadio; 


Como queremos reemplazar la función SoundAlarm( ) de AlarmClock. 
necesitamos cambiar la declaración del método SoundAlarmt ) para que sea 
protegida. Ademas, como queremos que la función Run ( ) tenga un compoita- 
niiento polimórfico. tendremos que hacer este método virtual: 

class AlarmClock 

{ 

prívate int currentTime; 
private int alarmTime; 
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protected virtual void SoundAlarm() 
{ 

Consolé. WnteLine ("Buzz ! " ) ; 

} 

// Otros métodos... 


Reemplazar SoundAlarm ( ) en AlarmClock es sencillo. Dependiendo de 
los valores de radioAlarm. se enciende la radio o se llama al método 
SoundAlarm ( ) de la clase base que hace sonar el timbre, como sigue: 

ClockRadio : AlarmClock 
{ 

private Radio radio; 
prívate bool radioAlarm; 

//- AlarmClock 

protected override void 
{ 

íf (radioAlarm) 

{ 

RadioOn ( ) ; 

} 

e 1 s e 
{ 

base.SoundAlarm(); 

} 

} 


Reemplazado 
S oundAla rm() 


// Otros métodos... 

} 


¡Y en esto consiste básicamente! Algo muy interesante está ocurriendo dentro 
del método Run ( ) de la clase AlarmClock (que aparece en el siguiente frag¬ 
mento de codigo): el comportamiento polimórfico al que aludíamos. La clase 
ClockRadio hereda este método de su clase base y no lo reemplaza. Por tanto, 
este método Run ( ) puede ser ejecutado desde un objeto de AlarmClock o un 
objeto de RadioClock. Como declaramos SoundAlarm ( ) de modo que fue¬ 
se virtual. C# es lo suficientemente inteligente como para llamar al 
SoundAlarm ( ) apropiado dependiendo de qué clase está invocando al método 
Run ( ) . 

class AlarmClock 
{ 

prívate int currentTime; 
prívate int alarmTime; 

public void Run() 

{ 

for (int currTime - 0; currTime < 43200; currTime++) 
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{ 

SetCurrentTime(currTime) ; 

if (GetCurrentTime () = = GetAlarmTime( ) ) 

{ 

Consolé.WriteLine("Current Time = {0}!”, currentTime); 

SoundAlarm(); 
break; 

} 

} 

} 


// Otros métodos..- 

} 

Este ejemplo resalta uno de los puntos fuertes de la herencia: el polimorfismo. 
Además, cuando se añaden nuevos métodos públicos (o protegidos) a la clase 
base, están automáticamente disponibles en la clase derivada. El listado 1 I 7 es el 
listado completo con un método main ( ) de ejemplo para que pueda experimen¬ 
tar con él. 

Listado 11.7. La herencia múltiple puede ser simulada usando la contención 

using System; 

namespace Containment 

{ 

class Radio 

{ 

protected bool on_off; 

public void On() 

{ 

if ( !on off) Consolé.WriteLine("Radio ís now on ! " i ; 
on off = true; 

} 

public void Off() 

{ 

if {on off) Consolé.WriteLine("Radio ís now off!"i; 
on off - false; 

} 

} 

class Alármelo c k 

{ 

prívate int cur rentTime; 
private int alarmTime; 

protected virtual void SoundAlarm() 

{ 

Consolé.WriteLine ( "Buzz ! ") ; 

} 
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public void Run() 


{ 

for (int currTime = 0; currTime < 43200; currTime++) 

{ 

SetCurrentTime(currTime); 
if (GetCurrentTime( ) == GetAlarmTime( ) ) 
í 

Consolé.WriteLine("Current Time = {0}!", 

cur rentTime) ; 

SoundAlarm(); 
break; 

} 



public int GetCurrentTime() 

{ 

return currentTime; 

} 

public void SetCurrentTime(int aTime) 

{ 

currentTime = aTime; 

} 

public int GetAlarmTime() 

{ 

return alarmTime; 

} 

public void SetAlarmTime(int aTime) 

{ 

alarmTime = aTime; 

} 


class ClockRadio : AlarmClock 

{ 

prívate Radio radio; 
private bool radioAlarm; 

public ClockRadio() 

{ 

radio = new Radio(); 
radioAlarm = false; 

} 

//- Delegar en Radio 

public void RadioOn() 

{ 

radio.On(); 

) 
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public void RadioOffO 


{ 

radio.Off(); 


//- AlarmClock Reemplazado 

protected override void SoundAlarm() 

{ 

if (radioAlarm) 

{ 

RadioOn () ; 

} 

else 

{ 

base.SoundAlarm(); 

} 


//- Nueva funcionalidad de ClockRadio 

public void S etRadioAlarm(bool useRadio) 

{ 

radioAlarm = useRadio; 

} 

} 


class Contlnh 

{ 

static int Main(string[] args) 

{ 


ClockRadio clockRadio; 

clockRadio = new ClockRadio{) ; 

clockRadio.SetRadioAlarm(true); 
clockRadio.SetAlarmTime(100 ) ; 
clockRadio.Run(); 

// esperar a gue el usuario reconozca los resultados 
Consolé .WriteLine("Hit Enter to termínate..."); 

Console.Read () ; 
return 0; 

} 

} 

} 


La clase de objeto .NET 


Todas las clases de C # derivan en última instancia de una clase construida en 
NET Framework llamada object. Si se escribe una clase en C# y no se define 
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una clase base para ella, el compilador de C# la deriva de object sin ningún 
aviso. Supongamos que escribimos una declaración de clase de C# sin una decla¬ 
ración de clase, como en este ejemplo: 

class Point2D 

Esto es equivalente a derivar la clase de la clase base .NET Sys tem. Ob j ect: 

class Point2D : System.Object 

La palabra clave object puede usarse como si fuera un alias del identificador 

System.Obj ect: 

class Point2D : object 

Si se deriva desde una clase base, hay que tener en cuenta que la clase base se 
deriva desde obj ect o desde otra clase base que herede de object. Al final, la 
jerarquía de las clases base siempre incline la clase NET object. 

Gracias a las reglas de herencia de C#. la funcionalidad de la clase NET 
object esta disponible para todas las clases de C#. La clase NET object 
contiene los siguientes métodos: 

• public virtual bool Equal s ( ob j ect ob j ) :Compara dos 
objetos y devuelve true si son iguales y false en caso contrario. Este 
método está marcado como virtual, lo que significa que se puede reempla¬ 
zar en las clases de C#. Quizás quiera reemplazar este método para compa¬ 
rar el estado de dos objetos de la clase. Si los objetos tienen los mismos 
v alores para los campos, puede devolver true; si los valores son diferen¬ 
tes puede devolver false. 

• public virtual int GetHashCode ( ) : Calcula un código hash 
para el objeto. Este método esta marcado como virtual, lo que significa que 
se puede reemplazar en las clases de C#. Las colecciones de clase de NET 
pueden llamar a este método para generar un codigo hash que ayude en las 
consultas y clasificaciones y las clases pueden reemplazar a este método 
para que genere un codigo hash que tenga sentido para la clase. 


NOTA: El código hash es una clave única para el objeto especificado. 


• public Typc GetType ( ) : Devuelve un objeto de una clase .NET 
llamado Typc que proporciona información sobre la clase actual. Este 
método no esta marcado como virtual, lo que significa que no se puede 
reemplazar en las clases de C#. 

• public virtual string ToString (): Devuelve una represen¬ 
tación de cadena del objeto. Este método está marcado como virtual, lo que 
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significa que se puede reemplazar en las clases de C#. Un método 
ToStrmg ( ) es invocado cuando algún método NET como 
System. Consolé . WriteLine ( ) necesita convertir una variable en 
una cadena. Se puede reemplazar este método para que devuelva una cade¬ 
na más apropiada para representar el estado de una clase determinada. 
Quizás quiera, por ejemplo, añadir el signo adecuado a cada divisa junto a 
la representación de cadena de la clase Money. 

• protected virtual void Finalize (): Puede ser llamado (o 
puede no serlo) cuando el recolector de objetos no utilizados del entorno de 
ejecución común destruye el objeto. Este método está marcado como vir¬ 
tual. lo que significa que se puede reemplazar en las clases de C#. También 
está marcado como protegido, lo que significa que sólo puede ser llamado 
desde dentro de la clase o desde una clase derivada y no puede ser llamado 
desde fuera de una jerarquía de clase. La implementación del objeto 
Finalize ( ) de .NET no hace nada, pero puede implementarlo si quiere. 
También puede escribir un destructor para su clase, lo que produce el 
mismo efecto (pero tenga cuidado al usarlo). De hecho, el compilador de 
C# convierte el código destructor en un método reemplazado Finalize () . 

• protected object MemberwiseClone (): Crea una copia idéntica 
del objeto, asigna al clon el mismo estado que el objeto original y devuelve 
el objeto copiado. Este método no está marcado como virtual, lo que signi¬ 
fica que no se puede reemplazar en las clases de C#. También está marca¬ 
do como protegido, lo que significa que sólo puede ser llamado desde dentro 
de la clase o desde una clase derivada y no puede ser llamado desde fuera 
de una jerarquía de clase. 

Las estructuras de C# no pueden tener clases bases definidas explícitamente 
pero se derivan implícitamente de la clase base ob j ect . Todo el comportamien¬ 
to de la clase object esta disponible para las estructuras y las clases de C#. 

Cómo usar boxing y unboxing para convertir 
a tipo object y desde el tipo object 

Como todas las clases y estructuras derivan en ultima instancia del tipo object 
de NET. éste suele usarse a menudo en listas de parámetros cuando el método 
necesita ser flexible respecto a los datos que recibe. 

Observe, por ejemplo, el método System. Consolé. WriteLine () usa¬ 
do en este libro. Este mismo método ha sido usado para escribir cadenas, enteros 
y tipos dobles en la consola sin usar ningún operador de conversión explícita. En 
el listado I 1.4. se escribe una cadena con comodines y los comodines son susti¬ 
tuidos por los valores de los parámetros que se le proporcionan. ¿C ómo funciona 
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en realidad 9 ¿Cómo sabe System. Consolé . WriteLine ( ) qué tipos le va 
a pasar 9 

La respuesta es que no puede saberlo. Microsoft constriñó el método 
System .Con solé.WriteLine ( ) mucho antes de que trabajásemos con el 
listado 1 1 4. por lo que no podía saber qué tipos de datos le pasaría. Microsoft 
implemento un método System . Consolé . WriteLine ( ) con la siguiente 
forma: 

public static void WriteLine(string format, params object[] arg] ; 

El primer parámetro es la cadena que se va a generar y el segundo parámetro 
es una matriz de parámetros que contiene una cantidad de elementos que se calcu¬ 
la cuando se compila el codigo. ¿Pero cuál es el tipo de la matriz de parámetros 9 
La matriz de parámetros es del tipo object. Observe esta llamada a 

WriteLine ( ): 

System. Consftlí? .WriteLine ( " ( { 0 } , { 1 } ) " , X, Y) ; 

El compilador de C# convierte los parámetros X e Y en una matriz de parámetros 
y llama a WriteLine ( ) . Los parámetros X e Y son de tipo entero, lo que. 
como ya ha visto, es un alias de una estructura llamada System. Int32. Como 
las estructuras de C# heredan del tipo de object de .NET. estas variables 
heredan del tipo object y pueden ser usadas en una matriz de parámetros. 

Eos literales, que se han estudiado con anterioridad, son algo más complica¬ 
dos. En lugar de usar objetos, puede igualmente escribir el siguiente código: 

System.Consolé.WriteLine ("({0} , { 1} ) ", 100, 200); 

Este codigo también funciona correctamente. ¿Cómo sabe C# cómo convertir 
un valor literal en un objeto para que pueda ser usado en una llamada de método 
que necesite un objeto 9 La respuesta esta en una técnica llamada boxing. 

La técnica de boxing permite que cualquier tipo de valor, incluso un literal, se 
pueda convertir en un objeto. Cuando el compilador de C# encuentra un tipo de 
valor para el que se necesita un tipo de referencia, crea una variable de objeto 
temporal y la asigna el valor del tipo de valor. Esta técnica "encierra" el valor en 
un objeto. 

Observe nuevamente la anterior llamada WriteLine { ) : 

System.Consolé.WriteLine("{{0}, {1})", 100, 200); 

El compilador de C# encuentra los literales y los encierra en objetos. Los 
objetos se envían a la llamada del método en la matriz de parámetros y a continua¬ 
ción se eliminan los objetos temporales. Observe las siguientes instrucciones: 

int MyVa lúe = J 2 3 ; 

object MyObject = MyValue; 

C# encierra el valor de MyVa|ue en el objeto MyObject. 
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C# también permite la técnica de unboxing. que es simplemente el proceso 
opuesto al boxing. El unboxing reconvierte los tipos de referencia en tipos de 
valor. Por ultimo, cada tipo es un objeto. El boxing y el unboxing nos ayudan a 
visualizar esta idea. Como todo es un objeto, todo (incluidos los literales) puede 
ser tratado como tal y los métodos de la clase object pueden llamarlos. El 
siguiente código funciona gracias a la técnica de boxing del compilador de C 

string MyString; 

MyStrmg = 12 3 . ToStrine; () i 

El compilador de C# aplica la operación boxing al valor literal I2.v 
trasformándola en un objeto y llama al método ToString ( ) sobre ese objeto. 


Resumen 

En la terminología de la programación de software orientado a objetos, la 
herencia se usa para describir una clase que hereda miembros de una clase base. 
C# admite la herencia simple, en la que una clase puede derivarse de una sola 
clase base. C# no admite la herencia múltiple, que si es admitida poi algunos 
lenguajes orientados a objetos para permitir que una clase pueda derivarse de mas 
de una clase base. 

Las clases base de C# se especifican al declarar una clase. El identificado!' de 
clase base sigue al nombre de la clase derivada cuando se declara la clase. 

C# permite que los miembros de clase pertenezcan a un atributo de ámbito. El 
ámbito de un miembro determina su accesibilidad para las clases derivadas y los 
fragmentos de código que trabajan con los objetos de la clase. Los miembros de 
clase marcados como public son visibles para las clases derivadas y para el 
código que crea los objetos de la clase. Los miembros de clase maleados como 
prívate solo son visibles para la clase en la que están definidos o desde clases 
derivadas de la clase. Los miembros de clase marcados como internal son 
visibles para todo el codigo en su mismo archivo binario, pero no son visibles 
fuera de los archivos binarios. Los miembros de clase marcados como protected 
internal son visibles para cualquier codigo en su mismo archivo binaiio v 
para las clases externas que se deriven de la elase. Los miembros de clase que no 
tienen ninguna palabra clave de ámbito son. por defecto, privados. 

Los métodos v las propiedades de clases base pueden implementarse de nuevo 
en clases derivadas para proporcionar nuev as implementaciones. Los métodos y 
propiedades virtuales, que están marcados con la palabra clave de ( # virtual, 
pueden implementarse nuevamente en clases derivadas, siempre que la nueva 
implementación mantenga el mismo identificador. tipo devuelto v lista de 
parametros. Las nuevas implementaciones de métodos virtuales reciben el nom¬ 
bre de reemplazadas v deben estar marcadas con la palabra clave de C# 
override. 
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Los métodos abstractos son métodos de clases base que no pueden ser 
implementados. Los métodos abstractos no suelen implemcntarse en clases base 
porque la clase base no tiene suficiente información como para ofrecer una 
implementación completa. Las clases que contienen al menos un método abstracto 
reciben el nombre de clases abstractas y deben usar la palabra clave abstract 
en la declaración de la clase. 

CU dispone de la palabra clave base que permite que las clases derivadas 
accedan a los miembros de una clase base. Se puede anteponer a los identificadores 
de miembros la palabra clave base y se puede usar esta palabra clave para 
llamar a un constructor de clase base desde un constructor de clase derivada. 

Por defecto, se puede usar cualquier clase de C# como clase base v cualquier 
clase puede derivarse de cualquier otra clase. Puede evitar este comportamiento 
marcando una clase de C# con la palabra clave sealed. Las clases selladas no 
pueden usarse como clase base y el compilador de CU no permite que se deriven 
clases a partir de clases selladas. 

Todas las clases de CU y. de hecho, cualquier clase implementada en un len¬ 
guaje NET. deriva en última instancia de la clase NET System. Obj ect . La 
palabra clave de CU obj ect es otro nombre para el identificador de clase 
System.Object. La clase System. Object contiene algunos métodos que 
pueden usar las clases derivadas y muchos de estos métodos pueden ser reempla¬ 
zados. La clase System. Obj ect proporciona funcionalidad para definir igualdad 
de objetos, cálculo de código hash. representaciones de cadenas, finalización de 
código y clonación de objetos. El tipo object puede ser usado como un método 
o variable de nombre de tipo y cualquier variable de CU puede usarse como un 
objeto object. CU convierte automáticamente algunos tipos de valor, como 
tipos de valor y literales numéricos y objetos de tipo object mediante las técni¬ 
cas de boxing y unboxing. La técnica de Boxing encierra un valor en un objeto v 
la técnica de unboxing devuelve el valor del objeto a su tipo de valor original 
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Parte III 

C# avanzado 





wX Cómo 
trabajar 
con espacios 
de nombre 


Las clases que diseñe las usará en su código y probablemente en el codigo de 
otras personas. Las clases de CU pueden ser usadas por una aplicación VB NE1 o 
desde dentro de una página ASP.NET. Ademas, las clases pueden ser usadas en 
combinación con otras clases diseñadas por otros programadores de NL í 

El código escrito en un lenguaje NET hace referencia a las clases por sus 
nombres v todas estas clases usadas en combinación suscitan un dilema eviden¬ 
te: ¿Qué ocurre si un programador quiere usar dos clases al mismo tiempo * 
Supongamos que escribe una clase de C U que lee archivos de una base de datos 
v llama a esa clase Record set. El codigo que quiera usar la clase puede crear 
objetos como el siguiente: 

Recordset MyRecordset - new Recordset(); 

Ahora supongamos que empaqueta las clases en un ensamblado NE1 y dis¬ 
tribuye ese ensamblado para que sea usado por otras aplicaciones. Ademas, su¬ 
ponga que alguien consigue su ensamblado y lo integra en su aplicación ¿Que 
ocurrirá si la misma aplicación también hace uso de otro ensamblado escrito por 
otra persona v que también contiene una clase llamada Recordset * C uando el 
código de la aplicación crea un nuevo objeto Recordset. ¿qué clase se usa para 
crear el objeto** ( ,La nuestra o la clase del otro ensamblado 4 * Este problema puede 
resolverse mediante el concepto de C# de los espacios de nombres. Los espacios 



de nombres organizan las clases mediante un grupo designado y el nombre del 
espacio de nombre puede ser usado para diferenciar dos clases con el mismo 
nombre. El código C# debe usar espacios de nombre para posteriormente ayudar 
a identificar nuestras clases mediante un grupo común, especialmente si está pla¬ 
neando construir un ensamblado para que sea usado por otros programadores. 
Los espacios de nombre pueden incluso ser útiles en las aplicaciones de C# que 
construyamos, porque de este modo pueden usar ensamblados externos que usen 
nombres de clase iguales a los nuestros. 

Cómo declarar un espacio de nombre 

Un espacio de nombre se declara con la palabra clave de C# namespace 
seguida por un identifícador de espacio de nombre y llaves. Las clases que se 
incluirán en el espacio de nombre deben declararse dentro de las llaves del espacio 
de nombre, como se puede ver en el siguiente código: 

namespace MyClasses 
{ 

class MyFirstClass 


} 

Este fragmento de código declara una clase llamada MyFirstClass en un 
espacio de nombre llamado MyClasses. Otro programador también podría es¬ 
cribir otra clase llamada MyFirstClass, pero mientras el otro programador 
use un espacio de nombre diferente, el compilador de C# encontrará la clase 
adecuada que debe usar para una instrucción particular. 

Es posible declarar espacios de nombre dentro de otros espacios de nombre. 
Basta con encerrar la declaración del segundo espacio de nombre en el interior de 
la primera declaración: 

namespace MyClasses 
{ 

namespace MylnnerNamespace 
{ 

class MyFirstClass 
{ 


} 



286 



rutinas de emulación de terminales. Estos espacios de nombre serían 
Widget. Compression y Widget.Emulation, que agrupan los 
productos de la compañía pero también los mantiene separados mediante el 
espacio de nombre Widget. 


Si no quiere anidar los espacios de nombre de esta manera, puede conseguir el 
mismo efecto declarando las dos declaraciones de espacio de nombre en la misma 
instrucción v separándolos con un punto, como se indica a continuación: 

namespace MyClasses.MyInnerNamespace 
{ 

class MyFirstClass 
{ 

} 

} 


Los siguientes tipos de declaraciones pueden aparecer en un espacio de nombre: 

• Clases 

• Estructuras 

• Interfaces 

• Enumeraciones 

• Delegados 

Cualquier declaración de un tipo que no esté en esta lista produce errores del 
compilador cuando se intenta compilar la aplicación. 

Cómo declarar un espacio de nombre 
en varios archivos fuente 


El compilador de C# permite el uso del mismo nombre de espacio de nombre 
en varios archivos fuente. A continuación crea un archivo binario que combina 
todas las clases en el mismo espacio de nombre. 

Supongamos, por ejemplo, que quiere construir un ensamblado cuyas clases 
residan en un espacio de nombre llamado MyAssembly. que quiere escribir dos 
clases para incluirlas en ese ensamblado y que quiere definir las clases en archi¬ 
vos separados. Puede simplemente reutilizar el nombre del espacio de nombre en 
los dos archivos fuente. El primer archivo fuente puede contener la declaración de 
la primera clase, como en el siguiente ejemplo: 

namespace MyAssembly 
{ 
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class MyFirstClass 


{ 

} 

} 

El segundo archivo fuente puede contener la declaración de la segunda clase \ 
puede usar el mismo nombre de espacio de nombre: 

ñamespace MyAssembly 

{ 

class MySeconde1ass 
{ 

} 

} 

Cuando los dos archivos fuente se construyen en un solo ensamblado, el 
compilador de C# crea un ensamblado con un solo espacio de nombre. 
MyAssembly. con dos clases en el espacio de nombre. 

Esto tiene una ventaja para el programador en caso de que quiera separar 
algunas funcionalidades en distintos archivos o simplemente, si quiere reducir al 
mínimo la longitud de cada archivo fuente. 

Cómo usar clases en un espacio de nombre 

Si quiere hacer referencia a una clase en un espacio de nombre especifico, 
anteponga al nombre de la clase el nombre de su espacio de nombre: 

MyC1 asses .MyFirstClass MyOb j ect - new MyClasses .MyFirstClass ( ; ; 

Esta sintaxis ayuda a distinguir entre las clases de diferentes códigos base con 
el mismo nombre. El compilador de C# v a tiene suficiente información para en¬ 
contrar la clase correcta, porque también sabe a qué espacio de nombre debe 
dirigirse para encontrar las clases que estamos buscando. 

Cuando se trabaja con clases declaradas en espacios de nombre anidados, 
deben aparecer todos los nombres de espacios de nombre cuando se hace referen¬ 
cia a esa clase: 


Namespacei.Ñamespace!.MyClass MyOb^ect = new 
N a mes pacel.Na me Space2.MyClass ( ) ; 

El listado 12 1 ilustra el concepto de espacio de nombre 

Listado 12.1. Clases en espacios de nombre diferentes 

namespace Namespacei 
{ 

class TestClass 
{ 
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public TestClass () 


System.Consolé.WriteLine("Helio from 
Ñamespace 1.TestClass!") ; 


} 

namespace Namespace2 
{ 

class TestClass 
{ 

public TestClass() 

{ 

System.Consolé.WriteLine("Helio from 
Namespace2.TestClass!"); 


class MainClass 
{ 

public static void Main() 

{ 

Namespace1.TestClass Objectl - new Namespace1.TestClass (} ; 
Namespace2.TestClass 0bject2 = new Namespace2.TestClass(); 



El código del listado 12.1 declara dos clases llamadas TestClass. Cada 
una de las declaraciones de clase está en un espacio de nombre diferente y el 
constructor de cada clase escribe un mensaje en la consola. Los mensajes son 
ligeramente diferentes de modo que se puede saber cual es el mensaje que emite 
cada clase. 

El método Main () del listado 12.1 crea dos objetos: uno de tipo 
Namespace 1 .TestClass y otro de tipo Namespace .TestClass, Como 
los constructores de las clases escriben mensajes en la consola, si se ejecuta el 
código del listado 12.1 obtendremos como resultado la figura 12 1 

Observe que la clase MainClass del listado 12.1 no está encerrada en una 
declaración de espacio de nombre. Esto es perfectamente válido en C#. No es 
necesario encerrar las clases en declaraciones de espacio de nombre. Sin embar¬ 
go. las clases que no están encerradas en espacios de nombre no pueden usar el 
mismo nombre en otra clase definida sin un espacio de nombre 

Si necesita usar una clase que está declarada en un espacio de nombre, debe 
usar el nombre de su espacio de nombre al usar el nombre de la clase. Si no hace 
esto, el compilador de C# emitirá un mensaje de error. Suponga, por ejemplo, que 
el método Main () del listado 12.1 intenta crear un objeto de la clase TestClass: 

TestClass Objectl - new TestClass (); 
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Figura 12.1. Cómo hacer referencia a clases dentro de espacios de nombre 


El compilador de C# no puede encontrar una clase llamada TestClass 
definida fuera de un espacio de nombre y emite el siguiente error: 

error CS0234: El tipo o el nombre del espacio de nombres 

'TestClass' no existe en la clase o el espacio de nombres 

'MainClass ' (¿falta una referencia de ensamblado?) 

Si revisa los ejemplos de los capítulos anteriores, comprobará que ésta es la 
sintaxis que hemos estado usando en todas nuestras llamadas a WriteLine { ). 
como muestra el siguiente ejemplo: 

System.Consolé.WriteLine("Helio from C#!"); 

El método WriteLine ( ) está en una clase llamada Consolé y la clase 
Consolé está definida en un espacio de nombre de NET llamado System. 

Cómo ayudar a los espacios de nombre 
mediante la palabra clave using 

Elav varias maneras de usar la palabra clave de C# using para facilitar el 
trabajo con los espacios de nombre y ahorrar una buena cantidad de código. A 
primera vista, la palabra clave using parece la típica directiva # inelude de 
C/C++. No se deje engañar; sus ventajas son mucho más potentes. Las siguientes 
secciones describen algunas de estas ventajas. 

Cómo crear alias de nombres de clase 
con la palabra clave using 

Escribir nombres de clase perfectamente válidos y que incluyan nombres de 
espacio puede ser un poco tedioso, especialmente si los nombres son largos. Puc- 





de usar la palabra clave using para crear un alias para el identificador de clase 
completo y, cuando se haya establecido el alias, puede usarlo en lugar del 
identificador de clase completo. Puede crear un alias mediante una instrucción 
que tenga la siguiente estructura: 

• La palabra clave using 

• El nombre del alias 

• Un signo igual 

• El nombre de la clase completa con el identificador de espacio de nombre 

• Un punto y coma de fin de instrucción 

El listado 12.2 se añade al listado 12.1 creando alias para los nombres de clase 
y acortando así sus equivalentes. El método Main ( ) utiliza los nombres acorta¬ 
dos para trabajar con los objetos de las clases. 

Listado 12.2. Cómo crear alias de los nombres de clase 

using Classl = Namespacel.TestClass; 

using Class2 = Namespace2.TestClass; 

namespace Namespacel 

{ 

class TestClass 
í 

public TestClass() 

{ 

System.Consolé.WriteLine("Helio from 

Ñamespacel.TestClass ! ") ; 

} 

} 

} 


namespace Namespace2 
{ 

class TestClass 
{ 

public TestClass() 

{ 

System.Consolé.WriteLine("Helio from 
Namespace2.TestClass ! ") ; 



class MainClass 
{ 

public static void Main() 
{ 
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Classl Objectl = new Classl () ; 
Class2 0bject2 = new Class2{); 



El listado 12.2 escribe los mismos mensajes que el anterior ejemplo. Puede ver 
estos resultados en la figura 12.2. 



Figura 12.2. Cómo crear alias de los nombres de clase 


Las instrucciones using deben incluirse en el eódigo fuente antes de que se 
declaren los espacios de nombres. Si aparecen después de las declaraciones de 
espacio de nombre, recibirá el siguiente mensaje de error del compilador de CU: 

error CS'1529: Una clausula using debe ir delante de todos los 

elementos restantes del espacio de nombres 

En capítulos anteriores ya vimos que las palabras clave de CU que definen los 
tipos de variable son en realidad estructuras definidas por NET Framework. 
Observe de nuevo la tabla 7.1 y preste atención a lo siguiente: 

• Las estructuras de tipo de valor residen en el espacio de nombre de NET 

System. 

• La palabra clave using se usa para crear alias de los nombres de estruc¬ 
turas de NET con las palabras clave de CU equivalentes. Puede imaginar 
como se implementa la tabla 7.1 en NET Framework mediante instruccio¬ 
nes de CU como las siguientes: 

using sbyte = System.SByte; 
using byte = System.Byte; 
using short = System.In116 ; 

// ... mas declaraciones . . . 




Puede crear alias de nombres de espacio de nombres así como de clases, 
como demuestra el listado 12.3. 

Listado 12.3. Creación de alias de espacios de nombre 

using NI = Namespacel; 
using N2 = Namespace2; 

ñamespace Namespacel 

{ 

c 1 a s s Test C1a s s 
{ 

pub1 ic TestClass () 

{ 

S y s tem. Consol e .WriteLme ("Helio f r om 
Ñamespace 1 .Tes t Class!"| ; 

} 

} 

} 

ñamespace Namespacel 

i 

class TestClass 
{ 

pub1 ic TestClass () 

{ 

System.Consolé .WriteLme ("Helio f r om 
Ñame s p a c e 2.TestClass ! ") ; 

} 

} 

} 

c 1 a ss MainClass 
{ 

public static void Main{) 

{ 

NI.TestClass Objectl = new NI.TestClass? 

N2.TestClass Object2 = new N2.TestClass ( ) ; 

} 

} 

Cómo declarar directivas de espacio de nombre 
con la palabra clave using 

Si usa una clase declarada en un espacio de nombre, debe anteponer al nombre 
de clase el nombre del espacio de nombre, aunque no este trabajando con ningún 
otro espacio de nombre que pueda tener una clase con el mismo nombre. Ésta es la 
razón por la que los ejemplos que hemos usado hasta este momento siempre han 
llamado a WriteLine ( ) con el calificador del espacio de nombre System: 


System.Consolé.WriteLine("Helio from C#!"); 



Por defecto, si no se usa el nombre de espacio de nombre, el compilador de 
C# emite un error: 

error CS0234: El tipo o el nombre del espacio de nombres 

'TestClass' no existe en la clase o el espacio de nombres 

'MainClass' (¿falta una referencia de ensamblado?) 

Anteponer cada nombre de clase con nombres de espacios de nombre como 
System es tedioso, especialmente si hay que hacerlo muchas veces. Afortunada¬ 
mente, se puede usar la palabra clave using para reducir el tiempo de codifica¬ 
ción. 

Al usar la palabra clave using con un nombre de espacio de nombre se 
advierte al compilador de C# que se quiere hacer referencia a clases en el espacio 
de nombres designado sin anteponer a los nombres de clase el nombre de espacio 
de nombre. Observe, por ejemplo, la siguiente instrucción: 

using System; 

Esto recibe el nombre de directiva de espacio de nombre. Las directivas de 
espacio de nombre avisan al compilador de C # de que el código usará clases del 
espacio de nombres y que las clases no llevarán antepuesto el nombre del espa¬ 
cio de nombre. El compilador de C# se encarga de encontrar la definición de 
cada clase en cada espacio de nombre al que se hace referencia en una directiva 
de espacio de nombre. 

El listado 12.4 es una modificación del listado 12.2; incluye una instrucción 
using que hace referencia al espacio de nombre de .NET System. 

Listado 12.4. Cómo usar una directiva de espacio de nombre 


using System; 

using Classl = Namespacel.TestClass; 
using Class2 = Namespace2.TestClass; 

namespace Namespacel 
{ 

class TestClass 
{ 

public TestClass() 

{ 

Consolé.WriteLine("Helio from Namespacel.TestClass!"); 

} 

} 


namespace Namespace2 
{ 

class TestClass 
{ 

public TestClass() 


294 



{ 

Consolé.WriteLine("Helio from Namespace2.TestClass!"); 

} 



class MainClass 
{ 

public static void Main() 

{ 

Classl Objecti = new Classl(); 
Class2 0bject2 • new Class2(); 



La directiva de espacio de nombre System del listado 12.4 permite que el 
código haga referencia a la clase Consolé sin que se le anteponga el espacio 
de nombre System. 

Un rápido recorrido por los espacios 
de nombre de .NET 


NET Framework tiene clases en multitud de espacios de nombre predefinidos 
que pueden usarse en otros códigos de C#. La siguiente lista describe algunos de 
ellos: 

• El espacio de nombre System contiene clases que implementan 
funcionalidades básicas, como conversiones de tipos de datos, operaciones 
matemáticas, invocación a programas y gestión del entorno de procesos. El 
espacio de nombre System es el mayor de los proporcionados por NET. 

NET Framework también contiene el espacio de nombre Microsoft 
que brinda compatibilidad con versiones anteriores, además de otros ele¬ 
mentos generalmente útiles. 

• El espacio de nombre System. CodeDOM contiene clases que represen¬ 
tan los elementos de un documento de código fuente. 

• El espacio de nombre System. Collections contiene clases que 
implementan colecciones de objetos, como listas, colas, matrices, tablas 
hash y diccionarios. 

• El espacio de nombre System. ComponentModel contiene clases que 
se usan para crear componentes y controles durante el tiempo de diseño y 
ejecución. Este espacio de nombre proporciona interfaces y clases para 
crear atributos, establecer enlaces a varias fuentes de datos, conceder li¬ 
cencias de componentes, además de para convertidores de tipos. 
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El espacio de nombre System. Data contiene clases que componen la 
arquitectura de acceso a datos de ADO.NET. La arquitectura ADO.NET 
permite construir componentes que pueden gestionar datos de varias fuen¬ 
tes de datos en modo desconectado o conectado. 

El espacio de nombre System.Diagnostics contiene clases que ayu¬ 
dan a detectar errores en aplicaciones de NET y supervisar la ejecución 
del código. El espacio de nombre System. Diagnostics también con¬ 
tiene clases que permiten supervisar la actuación de la aplicación mediante 
contadores de rendimiento y registros de eventos. Aunque la funcionalidad 
no se considera realmente un diagnóstico, este espacio de nombre también 
permite iniciar y detener procesos. 

El espacio de nombre System. Drawing contiene clases que implementan 
funcionalidad de dibujo del Dispositivo de interfaz gráfica (GDI). Este 
espacio de nombre no esta disponible por defecto; hay que crear una refe¬ 
rencia a él desde el menú Proyecto. 

El espacio de nombre System. 10 contiene clases que pueden leer y es¬ 
cribir flujos de datos y archivos de disco. Las clases contenidas en este 
espacio de nombre pueden gestionar la entrada y salida de archivos sincró¬ 
nica y asincrónica. 

El espacio de nombre System. Messaging contiene clases que traba¬ 
jan con colas de mensajes. Este espacio de nombre no está disponible por 
defecto: hay que crear una referencia a él desde el menú Proyecto. 

El espacio de nombre System. Net contiene clases que proporcionan un 
contenedor de clase para los muchos protocolos que se utilizan actualmen¬ 
te en las redes. Este espacio de nombre consta de clases para gestionar 
peticiones de DNS. HTTP y peticiones de FTP. Ademas de las clases gene¬ 
rales de acceso a redes, también hay muchas clases de seguridad de redes 
que tratan los diferentes aspectos de la seguridad, desde accesos a sitios 
Web hasta accesos de nivel de socket. 

El espacio de nombre System. Ref lection contiene clases que pro¬ 
porcionan una vista de tipos, métodos y campos disponibles para una apli¬ 
cación de NET. Incluso es posible crear e invocar tipos dinámicamente en 
el tiempo de ejecución usando las clases del espacio de nombre 

System.Reflection. 

El espacio de nombre System. Resources proporciona clases que per¬ 
miten a los programadores crear, almacenar y administrar recursos especí¬ 
ficos de las referencias culturales que se utilizan en las aplicaciones 

El espacio de nombre System. Runtime no es muy útil por sí mismo. 
Sin embargo, dispone de docenas de clases que proporcionan una enorme 



funcionalidad. Por ejemplo. System. Runtime . InteropSer- 

vices permite el acceso a objetos COM y a los API nativos desde 
NET. 

• El espacio de nombre System. Security contiene clases que permi¬ 
ten el acceso a la estructura subyacente de seguridad de .NET Framework 
El espacio de nombre de seguridad es el punto de partida para otros espa¬ 
cios de nombre más avanzados de muchos servicios de cifrado. Estos ser¬ 
vicios incluyen el cifrado y descifrado de datos, generación de hash y 
generación de números aleatorios. 

• El espacio de nombre System.Text contiene clases que permiten tra¬ 
bajar con codificaciones de caracteres ASCII. Unicode. UTF-7 y UTF-8 

• El espacio de nombre Sys tem. Threading contiene clases que permi¬ 
ten implemcntar varios subprocesos del sistema operativo en las aplicacio¬ 
nes NET. creando así una auténtica aplicación multiproceso. 

• El espacio de nombre Sys tem. Timers contiene clases que permiten 
desencadenar un evento en un intervalo de tiempo determinado o en unos 
plazos más complejos. Estos temporizadores se basan en el servidor. Un 
temporizador basado en un servidor tiene la capacidad de moverse entre 
los subprocesos para iniciar el evento, lo que proporciona una flexibilidad 
mayor que el temporizador típico de Windows. 

• El espacio de nombre System. Web contiene clases que implementan el 
protocolo de transmisión del hipertexto (HTTP) que utilizan los clientes 
Web para acceder a páginas de Internet. Este espacio de nombre no está 
disponible por defecto; hay que crear una referencia a él desde el menú 
Proyecto. 

• El espacio de nombre Sys tem. Windows . Forms contiene clases para 
crear aplicaciones completas para Windows. Las clases del espacio de 
nombre Sys tem. Windows . Forms proporcionan un entorno de clase 
NET con los controles típicos de Windows como cuadros de diálogo, menús 
v botones. Este espacio de nombre no está disponible por defecto; hay que 
crear una referencia a él desde el menú Proyecto. 

• El espacio de nombre System. Xml contiene clases que pueden procesar 
datos XML. Este espacio de nombre inclin e compatibilidad con espacios 
de nombre XML 1.0. XML. esquemas XML. XPath. XSL y XSLT. DOM 
Levcl 2. y SOAP 1.1. 

Aunque no es una lista completa, debería darle una idea de la inmensa cantidad 
de espacios de nombre ya implcmentados por .NET Framework. Consulte la do¬ 
cumentación del SDK de NET Framework para conseguir una lista completa de 
espacios de nombre y clases. 
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Resumen 


Las clases y estructuras que desarrolle se pueden encapsular en los llama¬ 
dos espacios de nombre. Los espacios de nombre ayudan a diferenciar unas 
clases y estructuras de otras que tengan el mismo nombre. 

Una clase o estructura completa incluye el nombre del espacio de nombre 
que alberga a la clase o estructura. Cuando se hace referencia a una clase o 
estructura en un espacio de nombre, hay que cualificar el nombre anteponien¬ 
do el nombre del espacio de nombre y un punto. 

Se puede usar la palabra clave using para facilitar el trabajo con los 
nombres de espacios de nombre en el código de C#. La palabra clave using 
puede usarse para proporcionar un alias para una clase particular en un espa¬ 
cio de nombre concreto. También puede usarse como una directiva de espacio 
de nombre, que avisa al compilador de C# de que nuestro código va a hacer 
referencia a clases en un espacio de nombre específico y de que el código no 
antepondrá el identificador de espacio de nombre a las clases de ese espacio de 
nombre. 

Puede crear sus propios espacios de nombre y puede usar el código incluido 
en espacios de nombre desarrollados por otras personas mediante las técnicas 
reseñadas en este capitulo. NET Framevvork incluye una gran cantidad de 
espacios de nombres llenos de clases, lo que facilita la labor de codificar 
cualquier cosa, desde aplicaciones Windows hasta procesadores de XML y 
programas de seguridad. Los espacios de nombre de .NET Framework tam¬ 
bién proporcionan clases que pueden usarse para crear código C# mediante 
técnicas avanzadas, como el software de multiproceso y la reflexión. 
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13 


Interfaces 


Una interfaz de C# es un conjunto de firmas de métodos, propiedades, exen¬ 
tos o indizadores agrupados con un nombre común. Las interfaces funcionan 
como conjuntos de funcionalidades definidas que pueden implementarse en una 
clase o estructura de C#. Las clases o estructuras que implementa una interfaz 
proporcionan implemcntaciones para todos los métodos definidos en la interfaz. 

Supongamos, por ejemplo, que queremos que las clases de nuestro provecto 
puedan guardar los valores de sus campos en una base de datos y recuperarlos 
más tarde. Al implementar este requisito, podríamos decidir que todas las clases 
deban implementar un método llamado Load ( ) y otro llamado Save ( ) Tam¬ 
bién podríamos definir los métodos en una interfaz llamada I Pers is tToDis k 
(los nombres de una interfaz comienzan normalmente con la letra I. aunque no es 
obligatorio en C#) y exigir que nuestras clases implementen esta interfaz. 

El código de C# puede consultar un objeto para determinar si admite una 
interfaz. Consultar a un objeto acerca de una interfaz es básicamente hacer la 
pregunta "¿Admites esta interfaz?" El objeto responde "Sí" o "No". Si el objeto 
responde "Sí", se puede llamar al método en la interfaz. Los métodos llamados en 
una interfaz siempre tienen la misma lista de parámetros y valores devueltos, 
aunque sus implementaciones pueden ser diferentes. 

Imagine una interfaz como un contrato, una promesa de que una clase 
implementará un conjunto específico de funcionalidades. Si un objeto responde 


301 




"Sí. yo admito la interfaz por la que está preguntando", está asegurando que pro¬ 
porciona una implementación para cada uno de los métodos definidos en la interfaz. 
Las interfaces no proporcionan sus propias implementaciones de métodos. Sólo 
proporcionan identifícadorcs de métodos, listas de parámetros y códigos devuel¬ 
tos. Las clases que implementan la interfaz son las responsables de proporcionar 
una implementación. Dos clases que implementan la misma interfaz pueden 
implementar los métodos de la interfaz de modos muy distintos. Esto es correcto, 
siempre que las clases sigan definiendo las firmas de los métodos en la definición 
de la interfaz. 

Vamos a usar la interfaz IPersistToDisk como ejemplo. Puede tener 
objetos en su aplicación que necesiten abrir su estado desde un disco y guardar su 
estado de nuevo en un disco. Podría decidir implementar la interfaz 
IPersistToDisk en estos objetos. Para cada uno de los objetos que implementen 
IPersistToDisk. necesitará escribir código para los métodos Load ( ) y 
Save ( ) de la interfaz. Algunos de los objetos pueden tener necesidades de alma¬ 
cenamiento básicas, de modo que esos objetos pueden implementar los métodos 
Save ( ) y Load ( ) mediante un simple código de E/S de disco. Otros objetos 
pueden ser más complicados y necesitan compatibilidad con la E/S transaccional. 
en la que toda la operación de persistencia debe tener éxito o fracasar como un 
todo. Para esos objetos, quizás prefiera implementar los métodos Load ( ) y 
Save ( ) usando código transaccional. más robusto. La clave está en que el códi¬ 
go que usan estos objetos no necesita saber si el objeto usa código simple o 
transaccional en su implementación. Sólo pregunta a cada objeto "¿Admites el 
método IPersistToDisk'.*" Para los objetos que responden "sí", el código que 
usa los objetos puede llamar a Load ( ) o Save ( ) sin necesidad de saber cómo 
están implementados realmente esos métodos. 

Conceptualmente, las interfaces son muy parecidas a clases base abstractas: 
las dos proporcionan una lista de métodos que deben ser implementadas por otros 
fragmentos de código. Sin embargo, hay una diferencia importante: las interfaces 
pueden ser implementadas sin importar la posición de la clase de implementación 
en una jerarquía de clases. Si se usan clases base abstractas, todas las clases que 
quieran implementar la funcionalidad deben derivarse directa o indirectamente de 
la clase base abstracta. Esto no ocurre con las interfaces: las interfaces pueden 
ímplementarse en cualquier clase, sin importar su clase base. Las clases no nece¬ 
sitan derivarse de una clase base específica antes de poder implementar una interfaz. 

El concepto de interfaz como modelo de diseño de software no es nueva; sin 
embargo, el modelo de objetos de componentes (COM) de Microsoft popularizó 
el concepto. COM trajo la idea de las interfaces (conjuntos específicos de 
funcionalidad implementados por un objeto) a la vanguardia del desarrollo de 
software basado en Windows. C# llevó más allá el concepto, promoviendo el 
concepto como una característica de lenguaje en el nivel de código. Aunque las 
primeras versiones de C++ o Visual Basic ya tenían interfaces COM integradas, 
estos lenguajes no eran compatibles con el concepto como rasgo de lenguaje. La 
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palabra clave de C# interface hace que el concepto de programación de 
interfaz sea compatible con el código fuente y esté disponible para el código, 
aunque el código no use COM. 

Este capítulo le enseña a trabajar con interfaces usando C#. Aprenderá a defi¬ 
nir una interfaz usando la palabra clave interface. También aprenderá a 
definir e implementar métodos, propiedades, indizadores y eventos en una interfaz 
y a acceder a una interfaz implementada por un objeto. 

Cómo definir una interfaz 


El primer paso al trabajar con interfaces en C# consiste en definir los métodos 
que componen la interfaz. Las interfaces se definen en C# con la siguiente sin¬ 
taxis: 

• La palabra clave interface 

• Un identificador de interfaz 

• Interfaces base opcionales 

• Una llave de apertura 

• Una o más declaraciones de miembro de interfaz 

• Una llave de cierre 

Las interfaces pueden definir métodos, propiedades, indizadores y eventos. 
Estos constructores de lenguaje trabajan sobre las interfaces del mismo modo que 
trabajarían con las clases de C#. Los métodos de interfaz definen bloques de 
codigo con nombre; las propiedades definen variables que pueden ser validadas 
mediante código descriptor de acceso y los eventos definen acciones que pueden 
ocurrir en el código. 

Cómo definir métodos de interfaz 

La agregación de un método a una interfaz significa que cualquier objeto que 
desee implementar la interfaz debe proporcionar una implementación del método 
de interfaz. Esto garantiza al código que los objetos que implementan la interfaz, 
incluvendo una implementación del método, pueden ser llamados por el código. 
Para definir un método en una interfaz, realice una declaración de método que 
proporcione el tipo devuelto por el método, el identificador y la lista de parámetros. 
La definición en C# de la interfaz IPersistToDisk que aparece al principio 
del capítulo sería: 

interface IPersistToDisk 

{ 

bool Load(string FileName); 
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bool Save(string FileName); 

} 

La interfaz define dos métodos, pero no proporciona ninguna implementación 
para los métodos. Las declaraciones de método terminan con un punto y coma 
Las clases de C# que implementa la interfaz IPersistToDisk prometen que 
proporcionarán una implementación de los métodos Load ( ) y Save ( ) tal y 
como se definen en la interfaz. 

^^ definir propiedades de interfaz 

piedades definen variables que pueden ser definidas por una interfaz. 
Al igual que las propiedades de clase, las propiedades de interfaz están asociadas 
con funciones de descriptores de acceso que definen el código que debe ejecutarse 
cuando se lea o escriba el valor de la propiedad. Para definir una propiedad en 
una interfaz hay que indicar el tipo de propiedad, el identificador y las palabras 
clave descriptoras de acceso seguidas de puntos y comas. Las palabras clave 
descriptoras de acceso aparecen entre llaves La clase o estructura que implementa 
la interfaz es la responsable de proporcionar la implementación de los descriptores 
de acceso de la propiedad. Para definir una propiedad de lectura/escritura en una 
interfaz hay que usar las palabras clave descriptoras de acceso get y set: 

interface Interfacel 

{ 

int RecordCount { get; set; } 

} 

Para definir una propiedad de sólo lectura en una interfaz, basta con incluir la 
palabra clave descriptora de acceso get: 

interface Interfacel 

{ 

int RecordCount { get; } 

} 

Para definir una propiedad de sólo escritura en una interfaz, basta con incluir 
la palabra clave descriptora de acceso set: 

rnterface Interfacel 

{ 

int RecordCount { set; } 

} 


Cómo definir indizadores de interfaz 

Los indizadores son propiedades especiales que permiten al codigo acceder a 
datos como si estuvieran almacenados en una matriz. Los indizadores pueden 
definirse en una interfaz del mismo modo que se definen en una clase. Para definir 
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un indizador en una interfaz hay que indicar el tipo del indizador. la palabra clave 
this. la lista de parámetros del indizador entre corchetes y las palabras clave 
descriptoras de acceso seguidas de puntos y comas. Las palabras clave descriptoras 
de acceso aparecen entre llaves. La clase o estructura que implementa la interfaz 
es la responsable de proporcionar la implementación de los descriptores de acceso 
del indizador. Para definir un indizador de lectura/escritura en una interfaz, use 
las palabras clave descriptoras de acceso get y set: 

interface Interfacel 

{ 

int this [int Index] { get; set; } 

} 

Para definir un indizador de sólo lectura en una interfaz, basta con incluir la 
palabra clave descriptora de acceso get: 

interface Interfacel 


int this [int Index] { get; } 

} 

Para definir un indizador de de sólo escritura en una interfaz, basta con incluir 
la palabra clave descriptora de acceso set: 

interface Interfacel 
{ 

int this [int Index] { set; } 

} 


Cómo definir eventos de interfaz 

Los eventos pueden definirse en una interfaz del mismo modo que se definen en 
una clase. Quizás quiera añadir un evento a la interfaz IPersistToDisk men¬ 
cionada al principio del capitulo para que. por ejemplo, se desencadene cuando 
las implementaciones de Save ( ) y Load ( ) empiecen a trabajar realmente con 
el disco para abrir o guardar los datos del objeto. Para definir un evento en una 
interfaz hay que usar la palabra clave event. el tipo del evento y un identificador 
de evento: 


interface Interfacel 
{ 

event EventHandler ClickEvent; 

} 

Cómo derivar a partir de interfaces base 

Las interfaces pueden derivarse de interfaces base, igual que las clases deri¬ 
van de clases base. Las interfaces base se escriben tras los dos puntos que 
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siguen al nombre de la interfaz derivada. A diferencia de las clases base, las interfaces 
pueden derivarse de más de una interfaz base. Los diferentes nombres de interfaces 
base se separan por comas, como se puede apreciar en el siguiente ejemplo: 

interface Interfacel 
{ 

void Methodl () ; 

} 

interface Interface2 
{ 

void Method2{); 

} 


interface Tnterface3 : Interfacel, Interface2 
{ 

} 


Es útil derivar de una interfaz base cuando una interfaz contiene un conjunto 
de firmas de método, propiedad y evento que deben ser añadidas a una interfaz 
ya programada. Por ejemplo. NET Framework define varias interfaces que pue¬ 
den implementarse y usarse en C#. Como las interfaces ya son una parte de 
NET Framework, la lista de métodos, propiedades, indizadores y eventos que 
admiten se ha consolidado y no puede cambiar. Si quiere usar una interfaz defini¬ 
da y necesita añadir más firmas a la interfaz para uso propio, debería considerar 
la posibilidad de derivar desde la interfaz ya definida y añadir sus nuevas firmas 
en la interfaz derivada. 

Las clases que implementan una interfaz derivada deben proporcionar 
implementaciones para todos los métodos definidos por las interfaces base. Cuan¬ 
do una clase implementa una interfaz, debe proporcionar el código para cada uno 
de los métodos definidos en la interfaz. Si una clase implementa Interface3. 
por usar el ejemplo anterior, la clase debe proporcionar las implementaciones de 
método para Methodl ( ) y Method2 ( ) . No se puede derivar una interfaz de 
ella misma. Observe la siguiente definición de una interfaz: 

interface Interfacel : Interfacel 

{ 

void Method1() ; 

} 


Este error hace que el compilador de C# produzca el siguiente mensaje de 
error: 

error CS0529: La interfaz heredada 'Interfacel' crea un ciclo 
en la jerarquía de la interfaz 'Interfacel' 

Este mensaje de error indica que el código está intentando derivar una interfaz 
de sí misma, lo que no se permite en C#. Las interfaces sólo pueden derivarse de 
otras interfaces. 
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Cómo usar la palabra clave new 
para reutilizar identificadores 

Se puede usar la palabra clave new para redefinir un identiñeador usado en 
una clase base. Suponga que está trabajando con una interfaz que define una 
propiedad llamada ID: 

interface Base Interface 

{ 

int ID { get; } 

} 

Ahora suponga que quiere derivar de esa interfaz, pero le gustaría usar el 
identificador ID como nombre de un método: 

interface Derivedlnterface : BaseInterface 

{ 

int ID () ; 

} 

Esta construcción hace que el compilador de C# emita un aviso sobre la 
reutilización del identificador ID: 

warning CS0108: La palabra clave new es necesaria en 

'Derivedlnterface.ID() ' porque oculta el miembro heredado 

'Baselnterface.ID' 

El compilador está avisando de que el identificador ID se está usando dos 
veces: una vez en la interfaz base y otra en la interfaz derivada como un nombre 
de método. 

La reutilizacion de este nombre puede confundir fácilmente a los usuarios de la 
interfaz. El aviso del compilador significa que el uso de la palabra clave ID en la 
interfaz derivada tiene prioridad sobre el uso de la palabra clave ID en la interfaz 
base. Si un fragmento de código recibe una implementación de la interfaz 
Derivedlnterf ace. el código será incapaz de llamar al método ID ( ) pero 
no puede acceder a la propiedad ID de la interfaz base. 

La reutilizacion del identificador ID en la interfaz derivada oculta el 
identificador ID en la clase base por lo que los clientes no pueden acceder a la 
propiedad de la interfaz base. 

Para resolver este problema se puede usar la palabra clave new al reutilizar el 
identificador. El uso de la palabra clave new. mostrado en el siguiente ejemplo, 
indica al compilador de C# que se quiere dar un nuevo uso al símbolo reutilizado: 

interface Derivedlnterface : Baselnterface 

í 

new int ID {) ; 

} 
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Cómo implementar interfaces en clases 
y estructuras 


Tras definir una interfaz, se puede implementar esa interfaz en clases y estruc¬ 
turas. Esto indica a los usuarios de la clase o estructura que ésta proporciona 
implementaciones a los constructores definidos en la interfaz. Por ejemplo, si 
implementamos en una clase la interfaz IPersistToDisk que aparecia en la 
introducción, informaremos a los usuarios de la clase que ésta proporciona 
implementaciones de los métodos Save ( ) y Load ( ) y que se puede llamar a los 
métodos. Las interfaces que se están implementando se identifican de la misma 
forma que las clases base, con una lista de nombres tras dos puntos que siguen al 
identificador de clase o de estructura: 

interface Interfacei 


void Method1(); 

} 


class MyClass : Interfacei 
{ 

void Method1() 

{ 

} 


Este código define una interfaz llamada Interfacei. El método Inter- 
facel declara un método: un método llamado Methodl ( ) . El codigo también 
declara una clase llamada MyClass. que implementa la interfaz Interfacei. 
La clase MyClass incluye una implementación para el método Method i { ) 
definido por la interfaz Interfacei. 

Aunque la clase solo puede derivarse de una clase base, puede implementar 
tantas interfaces como se deseen. Solamente hay que escribir las interfaces tras el 
identificador de clase y separar cada interfaz con dos puntos: 

class MyClass : Interfacei, Interfacei, Interface3 

La implementación de interfaz múltiple se usa en todo .NET Framework Por 
ejemplo, la clase System. String implementa cuatro interfaces definidas por 
.NET Framework: 

• (Comparable, que compara los valores de dos objetos del mismo tipo. 

• ICloneable. que crea un nuevo objeto que tiene el mismo estado que otro 
objeto. 

• (Convertible, que convierte el valor de un tipo a un valor de otro tipo. 

• IEnumerable, que permite que el código itere a través de una colección 
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Como la clase System. String implcmcnta estas cuatro intertaces, la 
funcionalidad que cada una de las interfaces proporciona es compatible con la 
clase System. String. Esto significa que las cadenas pueden ser comparadas 
con otras cadenas, pueden ser clonadas, pueden convertirse en otros tipos y se 
puede iterar a través de sus caracteres como si fuera una colección. El concepto 
de implementación de interfaz múltiple también está disponible para cualquier 
programador de C#. C# también permite derivar una clase de una clase base e 
implementar interfaces al mismo tiempo: 

class MyDerivedClass : CMyBaseClass, Interfacel, Interface2 

Las clases deben implementar cualquier declaración de evento, método, pro¬ 
piedad o indizador encontrado en una interfaz que implementen. En caso contra¬ 
rio. el compilador de C# emitirá un error. El siguiente código no funciona porque 
la clase MyClass implcmcnta Interfacel pero no proporciona una 
implementación del método Me thodl ( ) definido en Interfacel: 

interface Interfacel 

{ 

void Methodl(); 

} 


class MyClass : Interfacel 
{ 

public static void Main() 


El compilador de C# emite el siguiente mensaje de error al compilar el codigo: 

error CS0535: 'MyClass' no implementa el miembro de interfaz 
' Interface 1.Methodl() ' 

La clase debe proporcionar una implementación para la interfaz Methodl ( ) 
definida por Interfacel. dado que la clase implementa Interfacel. El 
siguiente ejemplo corrige el error: 

interface Interfacel 
{ 

void Methodl(); 

} 

class MyClass : Interfacel 

í 

public static void Mam () 

{ 

} 

public void Methodl() 

{ 

} 

} 


309 



Cómo implementar métodos de interfaz con 
el mismo nombre 


Debido a que es posible que el nombre de un método aparezca en más de una 
interfaz y como es posible que una clase de C# implemente más de una interfaz, 
puede ocurrir que se le pida a una clase de C# que proporcione múltiples 
implementaciones de diferentes interfaces que tengan el mismo nombre. Observe 
el método DoWork ( ) en el siguiente código: 

interface Interfacel 


v o i d D oW o r k () ; 

} 


interface Interface2 
{ 

v o i d D oW ork () ; 

} 

class MyClass : Interfacel, Interface2 
{ 

v oid D oWork() 

{ 

} 


Este código no se puede compilar. El compilador de C# emite el siguiente 
mensaje que indica el error que produce: 

error CS0536: 'MyClass' no implementa el miembro de interfaz 
' Interface 1.DoWork()' . MyClass.DoWork() ' es estático, no 
publico, o tiene un tipo de valor devuelto incorrecto, 
error CS0536: 'MyClass' no implementa el miembro de interfaz 
' Interface2.DoWork()' . MyClass.DoWork() ' es estático, no 
publico, o tiene un tipo de valor devuelto incorrecto. 

En los mensajes de error se muestra la sintaxis interfaz/nombre para recordar 
la sintaxis correcta de las implementaciones de clase. 

El problema es que la clase MyClass necesita proporcionar codigo de 
implementación para el método DoWork () definido por Interfacel y del 
método DoWork ( ) definido por Interface2 y las dos interfaces reutilizan el 
nombre de método DoWork ( ) . Una clase de C# no puede incluir dos métodos 
con el mismo nombre, de modo que ¿cómo se pueden definir los dos métodos de 
interfaz? 

La solución es anteponer el nombre de la interfaz a la implementación del 
método v escribir un punto que separe el nombre de la interfaz del nombre de la 
implementación. como se muestra a continuación: 
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class MyClass : Interfacel, Interface2 

{ 

void Interface 1.DoWork() 

{ 

} 

void Interface2.DoWork() 

{ 

} 

} 

Esta clase se compila correctamente ya que contiene dos implementaciones 
DoWork ( ) . una por cada interfaz definida. Como los nombres de método están 
calificados con los nombres de interfaz, el compilador de C# puede distinguir uno 
de otro v puede verificar que las dos interfaces han sido implementadas en la 
clase. 

Cómo acceder a miembros de interfaz 

Trabajar con clases que implementan interfaces es sencillo en C#. Normal¬ 
mente se realizan estas operaciones cuando se trabaja con objetos cuyas clases 
implementan interfaces: 

• Consultar un objeto para verificar que es compatible con una interfaz es¬ 
pecífica. 

• Acceder a una interfaz en un objeto. 

• Acceder a un miembro de la clase de un objeto definido inicialmente en una 
interfaz. 

Las próximas secciones estudian estas operaciones. 

Consultar a un objeto por una interfaz 

Dado que diseña e implementa su propio código, ya sabe qué clases se usan en 
su aplicación y qué interfaces admiten. Sin embargo, cuando se escribe código 
que puede ser empleado por otras aplicaciones NET y se reciben objetos de otros 
códigos, nunca se puede estar realmente seguro de qué interfaces admiten esos 
objetos. Por ejemplo, si está escribiendo un ensamblado y escribe código que 
acepta un tipo de objeto genérico, no puede saber si el objeto admite una interfaz 
dada. 

Puede usar la palabra clave is para comprobar si un objeto admite o no una 
interfaz. La palabra clave is se emplea como una parte de una expresión booleana 
que se construye como se indica a continuación: 
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• Un identificador de objeto. 

• La palabra clave is. 

• Un identificador de interfaz. 

La expresión devuelve True si el objeto admite la interfaz indicada v False 
en caso contrario. El listado 13.1 muestra el funcionamiento de la palabra clave 

is: 

Listado 13.1. Cómo usar la palabra clave is para trabajar con una interfaz 

using System; 

public interface IPrintMessage 

{ 

v o i d Prmt|) ; 

} ; 

class Class1 

{ 

public void Print() 

{ 

Consolé.WriteLine("Helio from Classl!"); 



class Cías s 2 : IPrintMessage 

{ 

public void Print ( ) 

{ 

Consolé .WriteLine ("Helio from Class2! ,f ); 

} 

} 

class MainClass 

{ 

public static void Main() 

{ 

PrintClassPrintObject = new PrintClass(); 
PrintObject . PnntMessages ( ) ; 

} 

} 

class PrintClass 

{ 

public void PnntMessages () 

{ 

Classl Objectl = new Classl (); 

Class2 0bject2 = new Class2 {) ; 

PrintMessageFromObject(Objectl); 
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PrmtMessageFromObject(Object2) ; 


prívate void PrintMessageFromObject(object obj ) 
{ 

if (obj is I Pr intMess age ) 

{ 

IPrintMessage PrintMessage; 

PrintMessage = (IPrintMessage)ob] ; 
PrintMessage.Print () ; 


} 

El listado 13.1 define una interfaz llamada IPrintMessage. La interfaz 
IPrintMessage define un método llamado Print. Al igual que todos los 
miembros de interfaz de C#. la interfaz IPrintMessage define miembros pero 
no los implementa. 

A continuación el listado implementa dos clases de control llamadas Cíass 1 
v Class2 . La claseClassl implementa un método llamado calied Print () . 
Como Classl no hereda de la interfaz IPrintMessage. el método Print ( ) 
implementado por la clase no tiene ninguna relación con el método Print ( ) 
definido por la interfaz IPrintMessage. La clase Class2 implementa un 
método llamado Print () . 

Como Class2 hereda de la interfaz IPrintMessage. el compilador de C# 
considera que el método Print ( ) implementado por la clase es una 
implementación del método Print ( ) definido por la interfaz IPrintMessage. 

A continuación el listado 13.1 define una clase llamada MamClass. que 
implementa el método Main ( ) de la aplicación v otra clase llamada 
PrintClass. El método Main() del listado 13.1 crea un objeto de la clase 
Pr intClass y llama a su método publico para que haga el trabajo de verdad. 

El listado 13.1 termina declarando una clase llamada PrintClass. Laclase 
PrintClass implementa un método publico llamado PrintMessages ( ) y 
un método de ayuda privado llamado PrintMessageFromObject ( ) . El 
método PrintMessages ( ) es el método al que llama el método Main ( ) . 
Como PrintMessageFromObject ( ) esta marcado como privado, sólo se 
le puede llamar desde otros fragmentos de codigo del objeto PrintClass y no 
puede ser llamado desde el codigo en otras clases. El método PrintMessages ( ) 
crea un objeto de clase Classl y un objeto a partir de Class2 y pasa cada 
objeto al método privado PrintMessageFromObject ( ) . El método priva¬ 
do PrintMessageFromObject ( ) acepta un parámetro de tipo object 
como parámetro. 


NOTA: Es posible usar un parámetro de tipo object gracias a que todos 
los tipos de variable que el CLR admite derivan en última instancia de 
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System.Object y la palabra clave de C# object es un alias para el 
tipo System.Object. Cualquier tipo de variable que pueda ser repre¬ 
sentada en C# puede ser usada como parámetro para un método que espere 
un tipo de objeto porque todos los tipos son, en última instancia, objetos de 

System.Obj ect. 


En la siguiente línea del listado 13.1. el método PrintMessageFrom- 
Object ( ) comienza examinando el objeto para comprobar si implementa la 
interfaz I Pr intMessage: 

íf (obj is I P r intMes s age ) 

Si el objeto implementa la interfaz, la expresión booleana obj is 
IPrintMessage devuelve True y el codigo situado por debajo de la condi¬ 
ción if se ejecuta. Si el objeto no implementa la interfaz, la expresión booleana 
obj is I Pr intMessage devuelve False y el codigo situado por debajo de 
la condición if no se ejecuta. 

Si el objeto admite la interfaz, se puede acceder a la implemcntación del objeto 
de la interfaz. Se puede acceder a la implemcntación de la interfaz de un objeto 
declarando una variable del tipo de la interfaz y luego convirtiendo explícitamen¬ 
te el objeto al tipo de la interfaz, como se indica a continuación: 

IPrintMessage PrintMessage; 

PrintMessage = (IPrmtMessage) obj ; 

Tras imcializar una variable del tipo de la interfaz, se puede acceder a los 
miembros de la interfaz usando la habitual notación con punto: 

PrintMessage.Print(); 

En el listado 13-2. se pasa Obj ect 1 al método Pr intMessage From- 
Object ( ) y no se escribe nada en la consola porque el objeto Obj ect 1 es de 
la claseClassl y Classl no implementa la interfaz IPrintMessage. Cuando 
se pasa Objectl al método PrintMessageFromObject ( ) . se escribe en 
la consola el siguiente texto: 

Helio from Class2! 

Este mensaje aparece porque el objeto Object2 es de clase Class2 y Class2 
implementa la interfaz IPrintMessage. Si se llama a la implementación del 
objeto del método Print de la interfaz se escribe el siguiente mensaje en la 
consola. 

Cómo acceder a una interfaz en un objeto 

Usar el operador is para trabajar con una interfaz requiere que el código 
acceda a un objeto dos veces: 
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• Una vez para consultar al objeto y comprobar si el objeto implementa una 
interfaz. 

• Una vez para acceder a la implementación de la interfaz del objeto usando 
el operador de conversión explícita. 

Se pueden combinar estos dos accesos mediante el operador as. El operador 
as realiza dos tareas en una sola instrucción. El listado 13.2 es una versión 
modificada del listado 13.1 que usa la instrucción as en lugar de la instrucción 

is: 


Listado 13.2. Cómo usar la palabra clave as para trabajar con una interfaz 

using System; 

public interface IPrintMessage 
{ 

void Print(); 

} ; 


class Classl 
{ 

public void Print() 

{ 

Consolé.WriteLine("Helio from Classl!"); 



class Class2 : IPrintMessage 
{ 

public void Print () 

{ 

Consolé.WriteLine ( "Helio from Class2!"); 

} 

} 

class MainClass 
{ 

public static void Main() 

{ 

PrintClass PrintObj ect = new PrintClass () ; 
PrintObj ect.PrintMessages() ; 



class PrintClass 
{ 

public void PrintMessages() 

{ 

Classl Objectl = new Classl(); 
Class2 Object2 = new Class2(); 
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PrintMessageFromObject(Objectl); 
Prmf.MessageFromObj ect (Obj ect2 ) ; 


prívate void PrintMessageFromObject(object obj) 

{ 

IPrintMessage PrintMessage; 

PrmtMessage = obj as TPrmtMessage; 

i f í P rintMossage ! = n u .1 1 ) 

P r i n!. Me- s s age . P r i n t f ) ; 

) 

f 

F1 operador as se usa como parte de una expresión que se construye como se 
indica a continuación: 

• Un identificado!' de objeto. 

• La palabra clave as. 

• Un identificado!' de interfaz. 

Si el objeto designado en la expresión implementa la interfaz designada en la 
expresión, la implementacion del objeto de la interfaz se devuelve como el resul¬ 
tado de la expresión Si el objeto designado en la expresión no implementa la 
interfaz designada en la expresión, se asigna al resultado de la expresión un valor 
vacio representado por la palabra clave de C# nuil. La nueva implementación 
del método priv ado Pr i ntMessageFromOb j ect ( ) usa el operador as. De¬ 
clara una variable local del tipo de la interfaz IPrintMessage v usa el opera¬ 
dor as para acceder a la implementación del objeto del método. 

Una vez que se ha completado la operación as. se comprueba la variable de 
implementación de la interfaz para descubrir si tiene el valor nul|. Si la variable 
no es nuil, se sabe que el objeto proporcionado implementa la interfaz v se 
puede llamar al método de la interfaz. 

FJ listado 13.2 es funcionalmente equivalente al listado 13.1 v escribe el si¬ 
guiente texto en la consola: 

Hp 1 l o f r om 0]a s s2! 

Declaraciones de interfaz y palabras clave 
de ámbito 

Al designar una interfaz, se puede marcar la interfaz como public. 
protected. internal o private. Si decide usar una de estas palabras 
claves para proporcionar un nivel de ámbito para la interfaz, debe colocarse 
inmediatamente antes de la palabra clave f nterface. 
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• Las interfaces marcadas como public son \isibles para cualquier frag¬ 
mento de código que tenga acceso al código en el que la definición de la 
interfaz pueda resolverse en tiempo de ejecución. Si se desarrolla un en¬ 
samblado y se implementa una interfaz publica en ese ensamblado, cual¬ 
quier aplicación de .NET que acceda al ensamblado podra trabajar con la 
interfaz. 

• Las interfaces marcadas comopr i vate solo son v isibles para la clase en 
la que se definen. Sólo las interfaces ciñ as definiciones están anidadas en 
clases pueden marcarse como prívate. 

• Las interfaces marcadas como protector! solo son visibles para las 
clases en la que son definidas o desde clases derivadas de la clase. Solo las 
interfaces ciñas definiciones están anidadas en clases pueden marcarse 

como protocted. 

• Las interfaces marcadas como interna! son visibles para cualquier 
código en el mismo archivo binario, pero no son visibles para el codigo que 
se encuentre en otros archivos binarios Si se define una interfaz en C # y se 
compila la clase formando un ensamblado, cualquier fragmento de codigo 
del ensamblado puede acceder a las interfaces internas. No obstante, si 
otro fragmento de código usa ese ensamblado, no tendrá acceso a la interfaz. 

C# permite especificar una interfaz sin especificar ninguna palabra clave de 
ámbito. Si se declara una interfaz sin especificar ninguna palabra clav e de ámbi¬ 
to. por defecto se le concede a la interfaz accesibilidad publica. 

Cómo implementar interfaces definidas 
por .NET Framework 


NET Framework define varias interfaces que se pueden implementar en otras 
clases. En este capítulo ya se ha mencionado que NET Framework define 
interfaces, como las interfaces ICloneable. IEnumerab.1 e. ICompareable 
e 1 Convertí ible que implementa la clase System. String. Implementar 
interfaces definidas por NET Framework puede ay udar a las clases a integrarse 
en NET Framework y en el entorno común de ejecución (el CER. para abre¬ 
viar). Observe este ejemplo. 

Cómo implementar foreach mediante 
lEnumerable lEnumerator 

El listado 9.3 del capitulo 9. implementa una clase llamada Rainbow. que 
incluve un indizador que permite utilizar los contenidos de la clase (cadenas que 
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nombran los colores del arco iris) como elementos de una matriz, como se mues¬ 
tra en el siguiente ejemplo: 

Rainbow MyRainbow = new Rainbow(); 

for (Colorlndex = 0; Colorlndex < MyRainbow.Count; ColorIndex + +) 

{ 

string ColorName; 

ColorName - MyRainbow[Colorlndex]; 

System.Consolé.WriteLine(ColorName); 

Se puede reducir aún más este código usando la palabra clave f oreach con 
la clase, como se muestra en el siguiente fragmento de código: 

Rainbow MyRainbow = new Rainbow(); 

f oreach (strmg Color in MyRainbow) 

Consolé.WriteLine(ColorName); 

Por defecto, las clases no admiten la palabra clave foreach y usarla para 
acceder a los elementos de la clase hace que el compilador de C# genere el si¬ 
guiente mensaje de error: 

error CS1579: La instrucción foreach no funciona en variables 

del tipo 'Rainbow' porque 'GetEnumerator' no contiene una 

definición para ' miembro ' o es inaccesible 

Sin embargo, se puede usar foreach en las clases si la clase implementa una 
interfaz de .NET Framework llamada IEnumerable. La interfaz IEnumerable 
contiene métodos que NET Framework usa para extraer elementos de los objetos. 
Si la clase contiene una colección de elementos y se quiere que otras partes del 
código usen la palabra clave f oreach para iterar cada uno de los elementos de 
la colección, hay que implementar la interfaz IEnumerable en la clase. 

La interfaz IEnumerable contiene una sola definición de método: 

IEnumerator GetEnumerator(); 

El método GetEnumerator () debe implementarse en la clase y debe de¬ 
volver un objeto que implementa otra interfaz NET Framework llamada 
IEnumerator. La interfaz IEnumerator es la responsable de implementar 
el código que devuelven los elementos de clase individuales. 

La interfaz IEnumerator define una propiedad y dos métodos como sigue: 

• object Current {get;} 

• bool MoveNext(); 

• void Reset(); 
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La propiedad Current devuelve una referencia al elemento actual de la 
colección. El método MoveNext ( ) se mueve al siguiente elemento de la eolec- 
ción v devuelve True si hay otro elemento a continuación o Faise si se ha 
llegado al final de la colección y no hay otro elemento a continuación. El método 
Reset ( ) devuelve el integrador al principio de la colección 

Cuando se accede a los datos de una clase con el constructor foreach. NET 
Framework accede a las interfaces de las clases IEnumerable e lEnumerator 
con código como el del siguiente pseudo-código: 

IEnumerable IEnumerabieImplementation; 

IEnumerator IEnumeratorImplementation; 

IEnumerablelmplementation = YourClass as IEnumerabie; 
íf(lEnumerablelmplementation !- nuil) 

{ 

lEnumeratorImplementation = 
lEnumerablelmplementation.GetEnumerator(); 

If(lEnumeratorImplementation ! = nuil) 

{ 

while(IEnumeratorlmplementation.GetNext() == true) 

CurrentValue = lEnumeratorImplementation.Current; 



Las interfaces IEnumerable e lEnumerator están definidas en un espa¬ 
cio de nombre de NET Framework llamado System. Collections y hay 
que hacer referencia a ese espacio de nombre cuando se trabaja con estas interfaces. 
Se puede hacer referencia a los nombres de espacio explícitamente: 

class MyClass : 

System.Collections.IEnumerable, 

System.Collections.lEnumerator 

Si se quiere, se puede usar en su lugar la palabra clave using para hacer 
referencia a los espacios de nombre: 

using System.Collections; 

class MyClass : 

I Enumerable, 
lEnumerator 

El listado 13.3 rcmodcla el listado 9.3 y usa la clase Rainbow para implementar 
las interfaces IEnumerable e lEnumerator; también usa el constructor 
foreach del método Main ( ) para recorrer los elementos de la clase. 

Listado 13.3. Cómo admitir foreach mediante IEnumerable lEnumerator 

using System; 

using System.Collections; 
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class Rainbow : IEnumerable, lEnumerator 

{ 

prívate short IteratorIndex = -1; 

public IEnumerator GetEnumerator() 

{ 

return this; 

} 


public object Current 

{ 

ge t 

{ 

switch(Iteratorlndex) 


case 0: 

return 
case 1 : 

return 
case 2 : 

return 
case 3 : 

return 
case 4 : 

return 
case 5 : 

return 
case t : 

return 
d e f a u 11 : 
retu r n 


Red" ; 
Orange"; 


Ye11ow"; 
Green"; 


Blue " ; 


Indigo"; 

V i o i e t" ; 

*** ERROR *** 


} 

} 

public bool MoveNext() 

{ 

IteratorIndex++; 
i f ílterator Inde - = 7 ) 

return false; 
return true; 

} 

public void Reset fj 

{ 

Iteratorlndex = -1; 

} 


public static void Mam() 

{ 

Rainbow MyRainbow = new Rainbowí); 
foreach (strmg ColorName in MyRainbow) 
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Consolé.WriteLine(ColorName); 


} 

} 

Si se ejecuta el código del listado 13.3 se escribe el siguiente texto en la 
consola: 

Red 

Orange 
Y e11ow 
Creen 
Blue 
Indigo 
Vi o 1et 

La clase Rainbow implementa las interfaces I Enumerable e 
IEnumerator. La clase mantiene un campo privado llamado IteratorIndex 
que se usa para seguir el rastro del siguiente elemento que debe devolverse en el 
bucle foreach. Se inicializa a -1: veremos por que cuando examinemos la 
implementación deMoveNext ( ) en las siguientes paginas. 

La implementación de clase de IEnumerable . GetEnumerator ( ) de¬ 
vuelve una referencia al objeto que se llama con la siguiente instrucción: 

return this; 

Recuerde que el método debe devolver una referencia a una clase que implemente 
el interfaz IEnumerator. Como el objeto usado para llamar a IEnumerable. 
Get Enumerator ( ) también implementa la clase IEnumerator. se Puede 
devolver el objeto al que se está llamando. Se puede usar la palabra clave this 
como valor devuelto. En este contexto. la palabra clave this hace referencia al 
objeto cuyo codigo se este ejecutando en ese momento. 

Como el compilador de C# puede determinar en tiempo real que el objeto que 
se ejecuta en ese momento implementa IEnumerable. el codigo no necesita 
convertir explícitamente la palabra clave this a una variable de tipo 
IEnumerator. El codigo resultante podría ser como el siguiente: 

return this as IEnumerator; 

Sin embargo, esto es redundante porque el compilador de C# ya puede com¬ 
probar que el objeto this (el objeto que se está ejecutando en ese momento) 
implementa la interfaz IEnumerator. Si se usa este codigo para devolver una 
referencia IEnumerator. recibirá el siguiente aviso del compilador de C#: 

warning CS0183: La expresión dada es siempre del tipo 
proporcionado ( 'System.Collections.IEnumerator ' ) 

El resto de la clase Rainbow implementa miembros de la interfaz 
IEnumerator. El primer miembro proporciona la implementación para la pro¬ 
piedad IEnumerator . Current. Examina el valor de la propiedad privada de 
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la clase Iteratorlndex y devuelve una cadena que representa el color del 
arco iris en el índice al que hace referencia el valor de la propiedad 
Iteratorlndex. La propiedad Current devuelve una variable de tipo 
object. pero como las cadenas son objetos igual que todos los otros tipos de 
datos, el CLR acepta los valores devueltos basados en cadenas. 

La iniplementación del método IEnumerator. MoveNext () incrementa 
el valor de la propiedad privada Iteratorlndex. Como el arco iris tiene siete 
colores, la iinplcmentación MoveNext ( ) da por sentado que los valores válidos 
de Iteratorlndex van de 0 a 6. Si el valor llega a 7. la implementación de 
MoveNext ( ) asume que el iterador ha llegado a su límite y devolverá False. 
En caso contrario, la implementación devuelve True. La instrucción que 
incrementa el valor de Iteratorlndex exige que el valor inicial de 
Iteratorlndex sea -1. Cuando se llama a MoveNext ( ) por vez primera, la 
instrucción de incremento aumenta el valor de Iteratorlndex de -1 a 0. 
dándole a Iteratorlndex un valor válido en la primera iteración del bucle. 

La implementación del método IEnumerator . Reset ( ) simplemente res¬ 
tablece el valor de Iteratorlndex a -1. A este método se le llama si se llama 
a más de un constructor f oreach y NET Framcvvork necesita devolver el esta¬ 
do de la enumeración a su valor inicial. 

Toda esta implementación hace que el método Main() sea muy claro. El 
método puede crear un objeto de la clase Rainbow y usar f oreach para iterar 
cada nombre de color de la clase. 

Cómo implementar limpieza mediante 
IDisposable 

El CLR contiene un mecanismo para la eliminación automática de objetos 
llamada recolección de objetos no utilizados. Es importante comprender cómo 
funciona este mecanismo, en qué se diferencia de otros sistemas y cómo hacer el 
código C# lo más compatible posible con este algoritmo para eliminar objetos 
creados. 

En C++. un objeto se crea con la palabra clave new y la operación devuelve al 
objeto un puntero ya que se crea en el montón de memoria de la aplicación. El 
programador en Cd—t debe liberar esta memoria invocando al operador dclcts 
sobre ese mismo puntero cuando el objeto ya no sea necesario. Al invocar al 
operador delete se libera la memoria usada por el objeto y se llama al destruc¬ 
tor de la clase para que la clase pueda realizar cualquier operación de limpieza 
especifica de clase. Si no se invoca al operador delete sobre un puntero de 
objeto devuelto por new. se produce pérdida de memoria. 

En algunos entornos de ejecución, como Visual Basic y COM. se lleva la 
cuenta de las referencias de los objetos. Los entornos de ejecución llevan la cuen¬ 
ta de los subprocesos asociados a un objeto y libera automáticamente el objeto 
cuando su contador de referencias llega a cero. Esto permite al programador 
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olvidarse de tener que llamar a una instrucción de destrucción como delete y 
ayuda a eliminar toda un tipo de errores relacionados con la pérdida de memoria. 

CLR usa un esquema de recuperación de memoria llamado recolección de 
objetos no utilizados. Los objetos no se destruyen cuando se libera su ultima 
referencia, como ocurre con los sistemas que cuentan las referencias, como COM 
y COM+ En su lugar, los objetos se destruyen algo más tarde, cuando el recolector 
de objetos no utilizados de CLR se ejecuta y destruye los objetos preparados para 
ser borrados. Los destructores de objetos de C# se ejecutan, no cuando se libera la 
última referencia del objeto, sino cuando el recolector de objetos no utilizados 
libera las estructuras de datos internas de CLR usadas para seguir la pista al 
objeto. Es importante tener en cuenta este diseño de recolección de objetos no 
utilizados al programar las clases de C#. Las clases que gestionan recursos y 
necesitan ser explícitamente cerradas cuando se destruye el objeto, como los 
controladores de conexiones de bases de datos, deben cerrarse tan pronto como 
el objeto deje de usarse. Insertar código de limpieza en el destructor de la clase 
significa que los recursos no serán liberados hasta que el recolector de objetos no 
utilizados destruya el objeto, que puede ser mucho después de que se libere la 
última referencia al objeto. 

NET Framework admite una interfaz llamada IDisposable que las clases 
pueden implementar para admitir recursos de limpieza de clases. La interfaz 
IDisposable se incluye en el espacio de nombre System de NET Framework. 
Admite un solo método llamado Dispose ( ) . que no toma parámetros y no 
devuelve nada, como se muestra en el siguiente ejemplo: 

using System; 

public class MyClass : IDisposable 

{ 

public MyClass() 

{ 

} 

-MyClass() 

{ 

} 


public void Dispose() 
{ 

} 


Esta clase admite un constructor, al que se llama cuando se crean los objetos 
de la clase; un destructor, al que se llama cuando el recolector de objetos no 
utilizados destruye los objetos de la clase; y Dispose { ) . al que se puede llamar 
cuando el código cliente se deshace del objeto. 

El código cliente puede consultar los objetos para ver si son compatibles con 
la interfaz IDisposable y puede llamar a su método Dispose ( ) para libe- 
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rar recursos de clase antes de que el recolector de objetos no utilizados destruya 
el objeto. El lenguaje C# realiza esta consulta de forma sencilla mediante una 
sintaxis especial que incluye la palabra clave using. La palabra clave using 
puede usarse en una expresión con paréntesis que incluye la creación de un nue¬ 
vo objeto: 

using(MyClass MyObj ect = new MyClass {) ) 

{ 

// use aquí "MyObject" 

} 

En este ejemplo, la palabra clave using se usa para crear un nuevo objeto 
llamado MyObject. El nuevo objeto pertenece a la clase MyObject. El objeto 
puede usarse en cualquier instrucción que esté incluida entre las llaves que si¬ 
guen a la palabra clave using. El objeto es automáticamente destruido cuando 
la ruta de acceso del código llega a la llave de cierre del bloque using. Si la 
clase del objeto creado en la instrucción using admite IDisposable. enton¬ 
ces el método Dispose ( ) de la clase es invocado automáticamente sin que el 
cliente deba hacer nada. El listado 13.4 muestra una clase llamada MyClass que 
implementa la interfaz IDisposable. 

Listado 13.4. IDisposable y la palabra clave using 


using System; 

public ciass MyClass : IDisposable 
{ 

public MyClass() 

i 

Consolé.WriteLine("constructor"); 

} 


-MyClass ( ) 

{ 

Con solé. WnteLme ("destructor") ; 

} 

public void Dispose() 

{ 

Consolé .WriteLme (" implementation of 
IDisposable.Dispose()"); 

} 


public class MainClass 
{ 

static void Main() 

{ 


USing(MyClass MyObject 


new MyClass () ) 



} 

} 

} 

Esta aplicación de consola implementa la clase MyClass mostrada en el lis¬ 
tado 13.4 y contiene instrucciones en su constructor, destructor e implementacion 
Dispose ( ) que escriben mensajes en la consola. El listado 13.4 también inclu¬ 
ye una instrucción using en su método Main ( ) que crea un objeto de tipo 
MyClass. Si se ejecuta el listado 13.4 se escribe el siguiente mensaje en la 
consola: 

constructor 

implementation of IDisposable.Dispose() 

dest ructor 

Observe que la implementacion Dispose ( ) de la interfaz IDisposable 
es invocada automáticamente sin que el método Main ( ) intervenga. 

Tenga en cuenta que sólo debe implementar la interfaz IDisposable para 
las clases que tienen recursos que deben ser liberados explícitamente, como co¬ 
nexiones de bases de datos o indicadores de ventana. Si la clase sólo contiene 
referencias a objetos gestionados por el CLR. entonces no es necesario implementar 
IDisposable. Implementar IDisposable significa que el CLR necesita 
realizar más trabajo para eliminar los objetos y este trabajo adicional puede 
ralentizar el proceso de recolección de elementos no utilizados. Implemente 
IDisposable cuando sea necesario pero no lo haga a menos que sea necesario. 


Resumen 


Piense en una interfaz como en una promesa de que una clase implementará los 
métodos, propiedades, indizadores y eventos definidos en la interfaz. Las interfaces 
proporcionan definiciones de miembros, pero no proporcionan ninguna 
implementacion Se necesita una clase que implemente una interfaz para propor¬ 
cionar una implementacion de cada uno de los miembros de la interfaz. Una clase 
puede implementar varias interfaces, aunque sólo puede derivarse de una de las 
clases base. Las interfaces pueden derivarse de otras interfaces, del mismo modo 
que las clases pueden derivarse de las clases base. 

Las palabras clave de C# is y as pueden usarse para trabajar con objetos que 
implementen interfaces. La palabra clave is se usa en una expresión booleana 
que devuelve True si un objeto implementa una interfaz y False en caso con¬ 
trario. La palabra clave as convierte una variable de objeto en una variable de un 
tipo de interfaz. Las expresiones que usan la palabra clave as devuelven nuil si 
el objeto no implementa la interfaz designada. 

En este capítulo se ve un ejemplo sobre como implementar una interfaz defini¬ 
da por NET Framework. .NET Framework implementa muchas interfaces y es 
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aconsejable revisar la documentación y estudiarlas todas. Las interfaces de .NET 
Framework comienzan con la letra/. Revíselas todas. Puede usar las interfaces de 
.NET Framework para implementar cualquier cosa, desde dar formato personali¬ 
zado a la consola para mecanizarla hasta la semántica de eliminación de la reco¬ 
lección de elementos no utilizados. 
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14 


Enumeraciones 


Algunas de las variables definidas en el código pueden usarse para contener un 
valor tomado de un conjunto de valores posibles. Por ejemplo, puede necesitar 
seguir el rastro del estado de un archivo Podría definir una variable que pudiera 
describir si un archivo está abierto, cerrado o si no se puedo encontrar Un modo 
de lograrlo sería escoger algunas constantes para definir las distintas opciones y 
un entero para que contenga el valor actual, como en el siguiente código: 

const int FileOpen - 1; 

const int FileClosed = 2; 

const int FileNotFound = 3; 

int FileStatus; 

FiieStatus - FileClosed; 

Este código es codigo C# válido y se compilará perfectamente. Sin embargo, 
un programador puede asignar a la variable un valor que no esté disponible en el 
conjunto de constantes definidas. El tipo de datos de FileStatus es un nume¬ 
ro entero y el compilador de C# acepta perfectamente cualquier código que asig¬ 
ne a la variable cualquier valor entero válido, aunque el objetivo es restringir el 
conjunto de valores válidos al conjunto definido por las constantes. En teoria. 
asignar a FileStatus un valor no definido por las constantes no debería estar 
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permitido porque lo que se pretendía en un principio era restringir el conjunto de 
valores posibles al conjunto definido para esa variable. 

La situación de desarrollo ideal en casos como éste es que debería ser posible 
definir una variable y asociar el valor a un conjunto de posibles valores válidos. 
Además, el compilador de C# debería ser capaz de evitar que los programadores 
asignen a la variable un valor no definido del conjunto de valores posibles. Como 
resultado, C# admite un constructor llamado enumeración que se ocupa de este 
caso concreto. 

Las enumeraciones son un grupo de constantes definidas con un nombre co¬ 
mún El nombre de la enumeración puede usarse como un tipo de variable una vez 
que se haya definido la enumeración. Cuando se usa una variable definida como 
un tipo de enumeración, el compilador de C# se asegura de que los valores asig¬ 
nados a las variables del tipo de la enumeración concuerden con uno de los valo¬ 
res del conjunto de constantes definidas en la definición de la enumeración. 

Las enumeraciones son ideales para las situaciones en las que una variable 
debe asociarse a un conjunto de valores específico. Supongamos, por ejemplo, 
que está escribiendo una clase de C# que controla una puerta electrónica y decide 
escribir una propiedad para la clase llamada DoorState. que abre o cierra la 
puerta: 

public int DoorState 

{ 

set 


} 


} 


InternalDoorState 


valué; 


También puede definir algunas constantes que se pueden usar para hacer el 
código más legible: 

public const int DoorStateOpen = 1; 
public const int DoorStateClosed = 2; 

La propiedad y las constantes permiten que el código que trabaja con los 
objetos de la clase pueda escribir código legible como el siguiente: 

DoorStateObject = new DoorClass(); 

DoorObject.DoorState - DoorClass.DoorStateOpen; 

DoorObject.DoorState - DoorClass.DoorStateClosed; 

El código anterior se compila y ejecuta sin problemas. Sin embargo, la propie¬ 
dad DoorState se define como un int y no hay nada que impida a los 
invocadores usar valores que no tienen sentido y asignarlos a la propiedad 

DoorState: 

DoorObject.DoorState = 12345; 
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Este código también es válido porque el literal 12 3 4 5 está dentro de los lími¬ 
tes válidos de un entero de C# y la propiedad DoorState está definida como 
poseedora de un tipo int. Aunque este código es válido desde el punto de vista 
de la compilación de C#. no tiene sentido en el nivel de clase porque el estado de 
la puerta en realidad sólo deberia ser abierta o cerrada. 

Podría crear algún código para la verificación de errores en la propiedad 
DoorState para que sólo acepte valores válidos, pero sería incluso mejor hacer 
que el compilador de C# imponga la restricción por nosotros cuando se crea el 
código. 

Las enumeraciones proporcionan el mecanismo en tiempo de compilación que 
está buscando. Le permiten agrupar las constantes relacionadas, como las cons¬ 
tantes DoorStateOpen y DoorStateClosed. bajo un nombre de grupo y 
usar ese nombre de grupo como un tipo de valor. Puede, por ejemplo, agrupar las 
constantes DoorStateOpen y DoorStateClosed en una enumeración lla¬ 
mada LegalDoorStates v redefinir la propiedad DoorState para que tra¬ 
bajen con un tipo de LegalDoorStates. en lugar de con un int. El compilador 
de C# puede entonces asegurar que los valores asignados a la propiedad son 
miembros de la enumeración y producirá un error si el valor no existe en la enu¬ 
meración. 

Cómo declarar una enumeración 


Puede declarar una enumeración en C# usando la siguiente sintaxis: 

• La palabra clave enum. 

• Un identificador de enumeración 

• Un tipo base opcional. 

• Identificadores de valor de enumeración separados por comas y entre lla¬ 
ves. 

La enumeración LegalDoorStates de la anterior sección se definiría como 
se indica a continuación: 

enum LegalDoorStates 

{ 

DoorS t at eOpen, 

DoorStateClosed 

} 

Cada uno de los miembros de las enumeraciones tiene un valor numérico aso¬ 
ciado. Por defecto, el valor numérico del primer valor es cero y el valor de cada 
uno de los otros miembros es una unidad mayor que el valor de la anterior enume¬ 
ración. Si se usan estas reglas y la enumeración definida anteriormente, el valor 
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por defecto de DoorStateOpen es 0 y el valor de DoorStateClosed es 

1. Si lo desea, puede invalidar estos valores asignando valores a los miembros cuan¬ 
do se definen usando el operador de asignación: 

enum LegalDoorStates 
{ 

DoorStateOpen = 100, 

DoorStateClosed = 150 

} 

Puede asignar los miembros a un valor literal o al resultado de una expresión 
constante: 

enum LegalDoorStates 
{ 

DoorStateOpen = {75 + 25), 

DoorStateClosed = 150 

} 

Si no se asigna un valor a un miembro concreto de la enumeración, se aplican 
las reglas de asignación de valor por defecto. Observe la siguiente enumera¬ 
ción: 

enum LegalDoorStates 
{ 

DoorStateOpen = 100, 

DoorStateClosed 

} 


Usando esta enumeración y las reglas de asignación de valor por defecto, el 
valor de DoorStateOpen es 100 y el valor de DoorStateClosed es 101. 

C# también permite el uso de un identificador de enumeración para asignar un 
valor a otro identificador: 

enum LegalDoorStates 

{ 

DoorStateOpen = 100, 

DoorStateClosed, 

LastState = DoorStateClosed 

} 

En este ejemplo, el valor de la enumeración LastState es igual al valor de 
la enumeración DoorStateClosed, que en este caso es igual a 101. Esto 
demuestra que dos identificadores en una enumeración tienen el mismo valor. 

Las enumeraciones corresponden a un tipo de valor particular. Este tipo co¬ 
rrespondiente recibe el nombre de tipo subyacente de la enumeración. Las enume¬ 
raciones pueden ser convertidas explícitamente a su tipo subyacente. Por defecto, 
el tipo subyacente de todas las enumeraciones es int. Si quiere usar un tipo 
subyacente diferente, especifique el tipo subyacente después de dos puntos que 
siguen al idcntificador de la enumeración: 
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short 


enum LegalDoorStates : 

{ 

DoorStateOpen = 100, 

DoorStateClosed 


Todas las asignaciones explícitas de valor deben usar valores que incluidos 
dentro de los límites válidos del tipo subyacente de la enumeración. Observe el 
error en la siguiente enumeración: 

enum Weather : uint 

{ 

Sunny - -1, 

Cloudy = - 2, 

Rain = -3, 

Snow - -4 

} 

Esta declaración de enumeración es un error porque el tipo subyacente es 
uint v las asignaciones usan valores negativos que están fuera de los valores 
legales de un uint. Si se compila la anterior enumeración, el compilador de C# 
emite los siguientes errores: 


error 

'uint' 

CS 00 3 1 : 

El 

valor 

constante 

' - 1 ' 

no 

se 

puede 

convertir 

error 

'uint ' 

CS 0 0 31 : 

El 

valor 

constante 

\ _ 0 f 

no 

s e 

puede 

convertir 

error 

'uint' 

CSO031 : 

El 

valor 

constante 

'-3' 

no 

se 

puede 

convertir 

error 

'uint' 

CS0031: 

El 

valor 

constante 

'-4' 

no 

se 

puede 

convertír 


Cómo usar una enumeración 


Tras haber definido la enumeración, se puede usar el identificador de enume¬ 
ración como un tipo de variable. El listado 14.1 muestra cómo la clase 
DoorController puede usar una enumeración. 

Listado 14.1. Cómo usar una enumeración 

public enum LegalDoorStates 
{ 

DoorState Op e n, 

DoorStateClosed 

} 


class DoorController 
{ 

private LegalDoorStates CurrentState ; 
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public LegaIDoorStates State 
{ 

ge t 
{ 

return CurrentState; 

} 

set 

{ 

CurrentState = valué; 

} 



class MamClass 

{ 

public static void Main() 

{ 

DoorContro11er Door; 

Door = new DoorControl1er(); 

Door.State - LegalDoorStates.DoorStateOpen; 

} 

} 

La enumeración LegalDoorStates esta definida fuera de una declara¬ 
ción de clase. Esto está permitido en C# y hace que la enumeración sea visible 
para todas las clases del archivo fuente. Una alternativa es definir las enumera¬ 
ciones dentro de una declaración de clase usando palabras clave de ámbito 
(public. protected. internal o private) para especificar el modo en 
que la enumeración es visible para las otras clases. 

Tras definir la enumeración LegalDoorStates. se puede usar su nombre 
como un tipo de variable. Se usa como tipo para el campo priv ado CurrentState 
de la clase DoorController y también como tipo de la propiedad publica 
State de la misma clase. 

Para referirse a una enumeración del código se usan el nombre de la enumera¬ 
ción y uno de los identificadores de la enumeración. Estos identificadores están 
separados por un punto, como se muestra en la siguiente instrucción: 

Door.State = LegalDoorStates.DoorStateOpen; 

El valor de la expresión LegalDoorStates . DoorStateOpen es igual 
al valor del identificador DoorStateOpen de la enumeración LegalDoor¬ 
States. Este valor se asigna a la propiedad State. La ventaja de este diseño 
basado en enumeraciones es que el compilador puede identificar los lugares donde 
el código intenta asignar a la propiedad State un valor diferente del valor pro¬ 
cedente de la enumeración. Observe el error en la siguiente instrucción: 

Door.State = 12345; 
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El anterior código es un error porque la propiedad State está definida como 
si tomase un valor de tipo LegalDoorStates y en su lugar se le asigna un 
valor entero. El código del anterior ejemplo produce el siguiente error del 
compilador de C#: 

error CS0029: No se puede convertir implícitamente el tipo 
'ínt' a 'LegalDoorStates' 

Cómo usar operadores en valores 
de enumeración 


Debido a que los valores enumerados tienen un tipo subyacente y un valor, lo 
logico es que escriba un codigo que trate con valores subyacentes. Puede usar 
varios operadores de C# con valores enumerados: 

• igualdad 

• desigualdad 

• menor que 

• mayor que 

• menor o igual que 

• mayor o igual que 

• suma 

• resta 

• AND 

• OR exclusivo 

• OR inclusivo 

• complemento bit a bit 

• incremento 

• decremento 

Por ejemplo, observe el listado 14.2. 

Listado 14.2. Cómo usar operadores con enumeraciones 

using System; 

public enum FileAttributes 
{ 
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AttrNone - 0, 
AttrReadOnly = 1, 

AttrHidden = 2, 

AttrReadyForArchive = 4 


class MainClass 
{ 

public static void Main() 

{ 

FileAttributes FileAttr; 

FileAttr = Fi 1eAttributes.AttrReadOnly | 
Fi1e A ttributes.AttrHidden; 

Consolé .WnteLine (Fi leAttr) ; 


} 

El codigo del listado 14.2 define un conjunto de valores enumerados que espe¬ 
cifican atributos para un archivo o un disco. Un archivo puede no tener atributos 
especiales (Fi leAtt ributes . AttrNone). atributos de solo lectura 

(FileAttr ibutes . AttrReadOnly). atributos ocultos (FileAttri- 
butes . H i dden) o atributos listos para ser archivados (FileAttributes . 
At t r Re ad y For Archive). 

El codigo del método Main () especifica una variable local llamada FileAttr. 
que es de tipo FileAttributes. 

El codigo asigna el valor a un archivo oculto de solo lectura mediante una 
operación OR sobre los atributos FileAttributes . AttrReadOnly v 
File At tributes. Hidden. El valor de la variable local se escribe a conti¬ 
nuación en la consola. Si se compila y ejecuta el listado 14.2 se escribe lo siguien¬ 
te en la consola: 

3 

El listado 14.2 produce el valor 3 porque el valor de la enumeración 
FileAttributes . AttrReadOnly. 1. se unió al valor de la enumeración 
FileAttributes . Hidden. 2. en una operación OR. Realizar una operación 
booleana OR con los valores 1 y 2 produce un resultado de 3. 

También puede convertir un valor enumerado a un valor con el tipo del tipo 
subyacente de la enumeración: 

enum IntEnum 

í 

EnumOne = 1 , 

EnumTwo, 

EnumThree 

} 


IntEnum IntEnumValue; 
int IntValue; 
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IntEnumValue = EnumTwo; 

IntValue = (int) IntEnumValue; // el valor es 2 

El código anterior convierte el valor de una variable de enumeración 
IntEnumValue a su equivalente entero y asigna el entero IntValue a ese 
valor. Como la variable IntValue es un entero estándar, se le puede asignar 
cualquier valor válido para un entero. No esta limitado al conjunto de valores 
definidos por la enumeración, aunque se le asigna un valor que procede de una 
variable enumerada. 

Cómo usar la clase .NET System.Enum 

El tipo enum de C# es en realidad un alias de la clase System. Enum defi¬ 
nida en .NET Framework. Podemos usar cualquiera de los miembros de la clase 
.NET System. Enum en las enumeraciones que definamos. 

Cómo recuperar nombres de enumeración 

El listado 14.3 muestra cómo el código puede trabajar con enumeraciones 
como objetos System. Enum. Se trata de una mejora del listado 14 1 que recu¬ 
pera el estado actual de la puerta y escribe el nombre del estado en la consola. 

Listado 14.3. Cómo recuperar una nombre de enumeración mediante GetNameQ 

using System; 

pubiia enum LegalDoorStates 

{ 

DoorStateOpen, 

DoorStateClosed 

} 


class DoorController 
{ 

prívate LegalDoorStates CurrentState; 

public LegalDoorStates State 
{ 

ge t 
{ 

return CurrentState; 

} 


set 


CurrentState - valué; 

} 


} 
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class MainClass 


{ 

public static void Main() 

{ 

DoorController Door; 
st.ring EnumName; 

Door = new DoorControl1er () ; 

Door.State = LegalDoorStates.DoorStateOpen; 
EnumName = LegalDoorStates.GetName(typeof 
(LegalDoorStates), Door.State); 

Consolé.WriteLine(EnumName); 


} 

El método Main ( ) del listado 14.3 usa el método GetName ( ) de la clase 
System. Enum para obtener una cadena que represente un valor de enumera¬ 
ción. El primer parámetro es un objeto Type que especifica la enumeración a la 
que se consulta. La expresión typeof (LegalDoor States ) devuelve un objeto 
.NET Type para el tipo especificado (en este caso, la enumeración 
Legal Do orStates). El segundo parametro es el valor de la enumeración ac¬ 
tual. de la que debe devolverse la representación de su cadena. La siguiente ins¬ 
trucción muestra cómo puede usarse el método GetName ( ) para obtener el 
nombre de un valor enumerado: 

EnumName = LegalDoorStates.GetName(typeof(LegalDoorStates), 

Door.State); 

Esta instrucción se interpreta como: "Devuelve una cadena que represente el 
nombre del valor de la propiedad Door. State. Este valor es una parte de la 
enumeración LegalDoorStates." 

Si se ejecuta el listado 14.3 se escribe lo siguiente en la consola: 

DoorS tateOpen 

También se puede usar el método Format ( ) para recuperar el nombre de un 
valor de enumeración, según su valor numérico. La llamada GetName ( ) del 
listado 14.3 puede reemplazarse por la siguiente llamada a Format ( ) : 

EnumName = LegalDoorStates.Format(typeof (LegalDoorStates) , 0, "g") ; 

El primer parámetro de Format ( ) es el mismo que el primer parametro de 
GetNames ( ) . que es el tipo de enumeración que se usa en la llamada. El segun¬ 
do parámetro de Format ( ) es el valor numérico que debe devolver la llamada 
El ultimo parámetro de Format ( ) es la cadena que especifica los contenidos 
de la cadena que debe devolver la llamada. La cadena de formato puede ser una 
de las siguientes: 

• g. que especifica que debe devolverse el valor de enumeración con el 
valor numérico que concuerde con el valor del segundo parámetro. 
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• x, que especifica que el valor del segundo parámetro debe devolverse 
como una cadena que represente el valor en notación hexadecimal 

• d. que especifica que el valor del segundo parámetro debe devolverse 
como una cadena que represente el valor en notación hexadecimal 

• f. que especifica que el valor debe ser tratado como un conjunto de valo¬ 
res enumerados combinados y que el método debe devolver una lista de 
valores delimitada por comas como una cadena 

El valor de formato f se creó para ser usado con enumeraciones que repre¬ 
sentan valores de bit. Observe la siguiente enumeración: 

public enum BitsToSet 

{ 

BitOSet = 1, 

BitlSet = 2, 

Bit2Set = 4, 

Bit3Set - 8 , 

Bit4Set - 16, 

Bit5Set = 32, 

Bit 6Set = 64, 

Bit 7 Set = 128 

} 

La enumeración anterior representa un conjunto de bits que pueden asignarse a 
un bv te. Se pueden asignar varios bits a una variable mediante el operador booleano 
OR. como en el siguiente ejemplo: 

BitsToSet Byte; 

Byte - BitsToSet.BitlSet | BitsToSet.Bit3Set | BitsToSet.Bit6Set; 

Llamar al método Format ( ) en la variable Byte con el parámetro de for¬ 
mato f devuelve una cadena que representa los nombres de los valores enumera¬ 
dos cuvos v alores se encuentran en la variable: 

BitlSet, Bit 3S et, BitbSet 

Cómo comparar valores de enumeración 

El método CompareTo ( ) de la clase System. Enum puede comparar una 
enumeración con otra y devolver un entero que describe la relación entre los dos 
v alores. Observe el listado 14.4. que compara el v alor de una v ariable enumerada 
con el valor determinado de la misma enumeración: 

Listado 14.4. Cómo comparar valores de enumeración con CompareTo() 

using System; 

public 


class MainClass 



public enum Color 
{ 

Red = 0, 

Orange, 

Y e11ow, 

Green, 

Blue , 

Indigo, 

Violet 


static void Main (J 


Color MyColor; 


MyColor - Color.Green; 


Consolé . WnteLine (" 

{ 0 } " , 

, MyC 

Consolé.WriteLine (" 

{ 0 } " 

, MyC 

Consolé.WriteLine(" 

{ 0 } " 

, MyC 


olor.Compárelo(Color.Red) ) ; 
o1or.CompareTo(Color.Green) ) ; 
olor.CompareTo(Color.Violet) ) ; 


El listado 14.4 declara una clase con una enumeración publica llamada Co¬ 
lor. Sus valores varían de 0 a 6. El método Main { ) declara una variable de 
tipo Color llamada MyColor y asigna el valor Green a la variable. A conti¬ 
nuación invoca a CompareTo ( ) para comparar el valor de la variable con otros 
v alores de la enumeración. El método CompareTo ( ) devuelve uno de estos tres 
valores: 

• -1 si el valor que se pasa como argumento a CompareTo ( ) tiene un 
valor superior al valor enumerado usado para invocar al método 

• 1 si el valor que se pasa como argumento a CompareTo { ) tiene un valor 
inferior al valor enumerado usado para inv ocar al método 

• 0 si los dos valores son iguales 

En el listado 14.4. se llama tres veces al método CompareTo ( ) . En la prime¬ 
ra llamada, la variable MyColor se compara con el valor Red. Como Green. 
que tiene el valor 3. tiene un valor superior a Red. que tiene el valor 0. 
CompareTo ( ) devuelve 1. En la segunda llamada, la variable MyColor se 
compara con el valor Green. Como los valores son iguales. CompareTo ( ) 
dev uelv e 0. En la ultima llamada, la variable MyColor se compara con el valor 
Violet. Como Green. que tiene el valor 3. tiene un valor inferior a Violet. que 
tiene un valor 6. CompareTo ( ) devuelve -1. 

El argumento usado en la llamada a CompareTo ( ) debe ser del mismo tipo 
que la enumeración usada para llamar al método. Usar cualquier otro tipo, inclu¬ 
so el tipo subyacente de la enumeración, produce un error en tiempo de ejecución 
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Cómo descubrir el tipo subyacente en tiempo 
de ejecución 

Descubrir el tipo subyacente de una enumeración en tiempo de ejecución es 
sencillo con el método GetUnderlyingType ( ) . Este método, al que se llama 
en el tipo de enumeración, en lugar de una variable del tipo, toma un parámetro 
Type que representa el tipo de la enumeración y devuelve otro objeto Type que 
representa el tipo subyacente de la enumeración. 

El método ToString ( ) puede ser llamado en el objeto Type devuelto 
para obtener un nombre legible para el tipo, como se muestra en el siguiente 
código: 

string FormatString; 

Type UnderlyingType; 

UnderlyingType = 

BitsToSet.GetUnderlyingType(typeof(BitsToSet)); 

Consolé.WriteLine(UnderlyingType.ToString()); 

Este código recupera el tipo subyacente para una enumeración llamada 
BitsToSet y escribe el nombre del tipo en la consola, que produce una cadena 
como la siguiente: 

System.Int32 

Cómo recuperar todos los valores 
de enumeración 

El método GetValues ( ) devuelve una matriz de todos los valores de enu¬ 
meración ordenados en orden ascendente según su valor numérico, como se puede 
ver en el siguiente código: 

Array ValueArray; 

ValueArray = Color.GetValues (typeof (Color)) ; 

foreach(Color Colorltem in ValueArray) 

Consolé.WriteLine(Colorltem.ToString()); 

Este código llama a GetValues ( ) en la enumeración Color definida con 
anterioridad. 

El método GetValues ( ) devuelve una matriz y se visita a los elementos de 
la matriz de uno en uno mediante la palabra clave foreach. El nombre de cada 
elemento de la matriz se escribe en la consola, como se puede ver a continua¬ 
ción: 

Red 

Orange 
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Y e11ow 
Gr een 
Blue 
Indigo 
Vi oíet 

Análisis de cadenas para recuperar valores 
de enumeración 

La clase Enum contiene un método de análisis de cadenas llamado Parse ( ). 
que acepta una cadena como entrada de datos y devuelve el valor de la enumera¬ 
ción cuyo nombre concuerda con la cadena proporcionada, como se puede ver en 
el siguiente ejemplo: 

Color.Parse(typeof(Color), "Blue"); 

Esta llamada devuelve un objeto que representa el valor enumerado llamado 
Blue en una enumeración llamada Color. Como muchos otros métodos de 
enumeración, el método Parse ( ) es llamado en el tipo, en lugar de una variable 
del tipo. 

El método Parse ( ) devuelve un objeto, que necesita ser convertido explíci¬ 
tamente en un valor del tipo apropiado. El siguiente ejemplo muestra cómo el 
método Parse ( ) pude ser usado como uno de los muchos modos de representar 
un valor enumerado: 

Color ColorValué; 
object ParsedObject; 

ParsedObject - Color.Parse(typeof(Color), "Blue"); 

Consolé .WnteLme (Par sedObj ect .GetType () . ToSt ring () ) ; 

ColorValue - (Color)ParsedObject; 

Consolé .WnteLme (ColorValue .ToStnng ( ) ) ; 

Consolé .WnteLme (Color. Format (typeof (Color) , ColorValue, "d") ) ; 

En este código, se llama a Parse ( ) en el tipo de enumeración Color v se le 
otorga una cadena de entrada Blue. Esta llamada dev uelv e un objeto y el codigo 
escribe el tipo del objeto en la consola. 

El objeto se conv ierte entonces explícitamente en una variable del tipo Color 
y se escribe en la consola el nombre del valor de la enumeración y el valor deci¬ 
mal: 

Ma inClass + Color 
B Lúe 
4 

Este resultado demuestra que el objeto devuelto por el método Parse ( ) es 
del tipo Color. La variable convertida, que es una variable de Color, tiene un 
nombre de cadena Blue y un valor decimal 4. 
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Resumen 


Las enumeraciones se emplean para agrupar un conjunto de constantes rela¬ 
cionadas. Al dar a sus enumeraciones un nombre, se puede usar ese nombre en el 
código como un tipo de variable una vez que se haya definido la enumeración. Las 
enumeraciones, por defecto, se basan en un conjunto de constantes int. Se puede 
invalidar este valor por defecto especificando un tipo subyacente para la enume¬ 
ración. Se pueden usar como tipo subyacente de una enumeración muchos de los 
tipos numéricos de C#. Se deben emplear enumeraciones cuando queramos que el 
compilador de C# garantice que las constantes con las que trabajamos en el códi¬ 
go proceden de un conjunto de valores válidos. 

Por defecto, el compilador de C# asigna valores numéricos a los identificadores 
de las enumeraciones. El primer identificador tiene el valor de cero y las otras 
enumeraciones aumentan su valor a partir de ahí. Si lo deseamos, se puede usar el 
operador de asignación para asignar un valor a un identificador de enumeración 
cuando se define la enumeración. 

Un valor en una enumeración se especifica escribiendo el nombre de la enume¬ 
ración. un punto y el nombre de los identificadores de enumeración. Los 
identificadores de enumeración pueden convertirse implícitamente al tipo subya¬ 
cente de la enumeración. Esta conversión implícita también permite el uso de 
algunos de los operadores de C# para trabajar con los valores de enumeración. 

Todas las enumeración de C# derivan de una clase base de NET llamada 
System. Enum. La clase System. Enum contiene algunos métodos útiles que 
pueden ayudar a obtener las máximas prestaciones de las enumeraciones. Este 
capítulo ha examinado la mayoría de estos métodos. 
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15 


Eventos 


y delegados 


En el flujo general del tipleo segmento de software orientado a objetos, un 
fragmento de codigo crea un objeto de una clase y llama a métodos de ese objeto. 
En este contexto, el invocador es el código activo porque es el código el que llama 
a los métodos. El objeto es pasivo, en el sentido de que espera y realiza una acción 
solo cuando se invoca a uno de sus métodos. 

Sin embargo, también se puede producir el contexto contrario. Un objeto pue¬ 
de realizar una tarea v avisar al invocador cuando ocurre algo durante el proceso 
A este algo se le llama un evento y la publicación de ese evento del objeto se le 
conoce como desencadenar un evento. 

El proceso activado por eventos, en el que fragmentos de codigo informan a 
otras piezas de codigo cuando se producen eventos relevantes, no es una novedad 
de NET La capa de interfaz de usuario de Windows siempre ha usado una forma 
de eventos para informar a las aplicaciones Windows cuándo los usuarios traba¬ 
jan con el ratón, presionan una tecla en el teclado o mueven una ventana Los 
controles ActiveX desencadenan eventos para los contenedores de control de 
ActiveX cuando el usuario realiza una acción que afecta al control. 

El lenguaje C# contiene palabras clave especiales que hacen que sea fácil 
desencadenar, publicar y procesar eventos en el código de C#. Se pueden usar 
estas palabras clav e para permitir que las clases de C# desencadenen y procesen 
eventos con el mínimo esfuerzo. 
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Cómo definir delegados 


Cuando se programan los eventos que desencadenan las clases de C#. es 
necesario decidir cómo recibe el evento otros fragmentos de código. Otros frag¬ 
mentos de código necesitan escribir un método que reciba y procese los eventos 
que se publican. Suponga, por ejemplo, que su clase implcmenta un servidor Web 
y quiere desencadenar un evento siempre que llega una solicitud de una página 
desde Internet. Otros fragmentos de código quizás quieran realizar alguna acción 
cuando la clase desencadene este evento new request y ese código deberia 
incluir un método que se ejecute cuando se desencadene el evento. 

El método que implementan los usuarios de la clase para recibir y procesar los 
eventos es definido por un concepto de C# llamado delegado. Un delegado es una 
especie de "función patrón" que describe el aspecto que tiene el controlador de 
eventos del usuario. Un delegado también es una clase que tiene una firma v 
contiene referencias a métodos. Es como una función puntero, pero puede conte¬ 
ner referencias a métodos estáticos y de instancia. Para los métodos de instancia, 
el delegado almacena una referencia al objeto y al punto de entrada de la función 
Un delegado define lo que debe devolver el controlador de eventos del usuario v lo 
que debe ser la lista de parámetros. 

Para definir un delegado en €#. hay que usar la siguiente sintaxis: 

• La palabra clave de C# delegate. 

• El tipo devuelto por el controlador de eventos. 

• El identificador de delegado. 

• La lista de parametros del controlador de eventos, entre paréntesis. 

Si se declaran delegados en la clase que desencadena el evento, se les puede 
anteponer las palabras clave public. protected, internal o prívate 
como se pueden ver en este ejemplo de una definición delegate. 

public delegate void EvenNumberHandler(int Number); 

En este ejemplo se crea un delegado público llamado EvenNumberHandler 
que no devuelve nada. Este delegado sólo define un parámetro para ser pasado, de 
tipo int. El identificador de delegado. EvenNumberHandler. puede ser cual¬ 
quier nombre que elija mientras no le dé el nombre de una palabra clave de C#. 

Cómo definir eventos 

Para aclarar lo que es en realidad un evento, vamos a empezar con un ejemplo. 
Está conduciendo en su coche y aparece en el salpicadero la luz que índica que 
queda poco combustible. Lo que en realidad ha ocurrido es que un sensor en el 
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depósito de gasolina ha avisado al ordenador de que el nivel de combustible está bajo. 
El ordenador entonces desencadena un evento que a su vez enciende la luz del salpi¬ 
cadero para que sepa que tiene que comprar más combustible. En pocas palabras, un 
evento es un medio que tiene el ordenador de avisarle de una condición. 

Para definir un evento que desencadene una clase se usa la palabra clave de 
C# event. En su forma más simple, las declaraciones de eventos de C.# usan la 
siguiente sintaxis: 

• La palabra clave de C# event. 

• El tipo de evento. 

• El identificador de evento. 

El tipo de evento concuerda con un identificador de delegado, como se muestra 
en el siguiente ejemplo de servidor Web: 

public delegate void NewRequestHandler(string URL); 

public class Webserver 

{ 

public event NewRequestHandler NewRequestEvent; 

// . . . 

} 

Este ejemplo declara un delegado llamado NewRequestHandler. 
NewRequestHandler define un delegado que sirve como una plantilla para 
los métodos que procesan el evento new request. Todos los métodos que 
necesitan procesar el evento new request deben obedecer las convenciones de 
llamada del delegado: no deben devolver ningún dato y deben tener una sola 
cadena como lista de parámetros. Las implementaciones de control de eventos 
pueden tener cualquier nombre de método mientras su tipo devuelto y su lista de 
parámetros concuerden con el patrón de delegados. 

La clase Webserver define un evento llamado NewRequestEvent . El 
tipo de este evento es NewRequestHandler. Esto significa que sólo los con¬ 
troles de evento escritos para que concuerden con las convenciones de llamada del 
delegado pueden ser usadas para procesar el evento NewRequestEvent. 


Cómo instalar eventos 

Tras escribir el controlador de eventos, hay que crear una nueva instancia de 
él e instalarlo en la clase que desencadena el evento. Para crear una nueva 
instancia de controlador de eventos debe crear una nueva variable del tipo dele¬ 
gado v pasar el nombre del método controlador de eventos como un argumento. 
Usando el ejemplo del cliente Web. la creación de una nueva instancia controladora 
de eventos puede tener este aspecto: 
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public void MyNewRequestHandler(string URL) 
{ 

} 


NewRequestHandler Handlerlnstance; 

HandlerInstance = new NewRequestHandler(MyNewRequestHandler); 

Tras crear la nueva instancia controladora de eventos, se usa el operador += 
para añadirla a la variable de evento: 

NewRequestEvent +- Handlerlnstance; 

Esta instrucción enlaza la instancia de delegado Handlerlnstance, que 
admite el método MyNewRequestMethod. con el evento NewRequestEvent. 

Mediante el operador + = . se pueden enlazar tantas instancias de delegado como 
quiera para un evento. 

Del mismo modo, puede usar el operador -= para eliminar una instancia de 
delegado de un evento: 

NewRequestEvent -= Handlerlnstance; 

Esta instrucción desenlaza la instancia de delegado Handlerlnstance del 
evento NewRequestEvent. 


Cómo desencadenar eventos 

Se puede desencadenar un evento desde una clase usando el identificador del 
evento (como el nombre del evento) como si fuera un método. La acción de invo¬ 
car un evento como un método desencadena el evento. Desencadenar el evento 
new request en el ejemplo del servidor Web puede tener el siguiente aspecto: 

NewRequestEvent(strURLOfNewRequest); 

Los parámetros usados para desencadenar el evento deben coincidir con la 
lista de parámetros del delegado del evento. El delegado del evento 
NewRequestEvent se definió para aceptar un parámetro de cadena; por tanto, 
se debe proporcionar una cadena cuando se desencadene el evento desde la clase 
del cliente Web. 

Cómo unirlo todo 


El listado 15.1 muestra delegados y eventos en acción. El código implcmcnta 
una clase que cuenta desde 0 hasta 1 00 y desencadena un evento cuando encuen¬ 
tra un numero impar durante el proceso de contado. 
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Listado 15.1. Cómo recuperar eventos de número impar 

using System; 

public delegate void EvenNumberHandler ( int Number) ; 

class Counter 

{ 

public event EvenNumberHandler OnEvenNumber; 
public Counter() 

í 

OnEvenNumber - nuil; 

} 

public void Count.Tol 0 0 () 

{ 

int CurrentNumber; 

for (CurrentNumber = 0; CurrentNumber <- 1UÜ; 

CurrentNumber++) 

{ 

íf(CurrentNumber 2 = = 0) 

{ 

if (OnEvenNumber != nuil) 

{ 

OnEvenNumber(CurrentNumber); 



class EvenNumberHandlerClass 

{ 

public void EvenNumberFound{int EvenNumber) 

{ 

Console.WriteLine(EvenNumber); 



class MainClass 

{ 

public static void Main() 

{ 

Counter MyCounter = new Counter() ; 

EvenNumberHandlerClass MyEvenNumberHandlerC1ass = new 
EvenNumberHandlerClass () ; 

MyCounter.OnEvenNumber += new 

EvenNumberHandler(MyEvenNumberHandlerClass.EvenNumber Found) 
MyCounter.CountTo100 () ; 


} 



Para compilar esta aplicación hay que crear una nueva aplicación de consola 
en Visual Studio y copiar en ella el código fuente o simplemente usar el bloc 
de notas para guardar el archivo y a continuación usar: 

ese <filename> 

El listado 15.1 implementa tres clases: 

• La clase Counter es la clase que realiza el cálculo. Implementa un méto¬ 
do publico llamado CountTolOO () y un evento público llamado 

OnEvenNumber. El evento OnEvenNumber es del tipo delegado 
EvenNumberHand1er. 

• La clase EvenNumberHandlerClass contiene un método publico lla¬ 
mado EvenNumberFound. Este método actúa como el controlador de 
evento para el evento OnEvenNumber de clase Counter. Imprime en la 
consola el entero proporcionado como parámetro. 

• La clase MainClass contiene el método Main ( ) de la aplicación. 

El método Main ( ) crea un objeto de clase Counter y da nombre al objeto 
MyCounter. También crea un nuevo objeto de clase EvenNumber¬ 
HandlerClass y llama al objeto MyEvenNumberHandlerClass. 

El método Main () llama al métodoCountTolOO ( ) del objeto MyCounter. 
pero no antes de instalar una instancia de delegado en la clase Counter. El 
código crea una nueva instancia de delegado que gestiona el método 
EvenNumber Found del objeto MyEventNumberHand lerClass y lo aña¬ 
de al evento OnEvenNumber del objeto MyCounter usando el operador +=. 

La implementación del método CountTolOO usa una variable local para 
contar desde 0 a 100. Cada vez que pasa por el bucle contador, el código com¬ 
prueba si el número es par examinando si el número tiene resto al div idirse entre 
dos. Si el número es par. el código desencadena el evento OnEvenNumber y 
proporciona el numero par como el argumento para hacerlo coincidir con la lista 
de parámetros del delegado de eventos. 

Como el método EvenNumber Found de MyEvenNumberHandlerClass 
estaba instalado como un controlador de eventos y como ese método escribe el 
parámetro proporcionado en la consola, si se compila y ejecuta el código del 
listado 15.1. se escriben en la consola los números pares entre 0 y 100. 

Cómo estandarizar un diseño de evento 

Aunque C# acepta perfectamente cualquier diseño de delegado que se pueda 
compilar. NET Framework prefiere que se adopte un diseño estándar para los 
delegados. El diseño de delegados preferido usa dos argumentos: por ejemplo, el 

SystemEventhandler: 
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• Una referencia al objeto que desencadenó el evento. 

• Un objeto que contienen datos relacionados con el evento. 

El segundo parámetro, que contiene todos los datos del evento, debe ser un 
objeto de un clase que derive de una clase NET llamada System. EventArgs. 
El listado 15.2 remodela el listado 15.1 usando este diseño preferido. 

Listado 15.2. Cómo recuperar números impares con la convención 
de delegados NET 


using System; 

public delegate void EvenNumberHandler (obj ect Ongmator, 
OnEvenNumberEventArgs EvenNumberEventArgs); 

class Counter 

{ 

public event EvenNumberHandler OnEvenNumber; 

public Counter() 

{ 

OnEvenNumber = nuil; 

} 


public void CountTolOO() 

{ 

int CurrentNumber; 

for (CurrentNumber = 0; CurrentNumber <=? 100; 

CurrentNumber++) 

{ 

if (CurrentNumber 2 = = 0) 

í 

if (OnEvenNumber != nuil) 

{ 

OnEvenNumberEventArgs EventArguments; 

EventArguments = new 
OnEvenNumberEventArgs(CurrentNumber); 

OnEvenNumber(this, EventArguments ) ; 


} 

public class OnEvenNumberEventArgs : EventArgs 

{ 

prívate int EvenNumber; 

public OnEvenNumberEventArgs(int EvenNumber) 


351 



{ 

t. hi s . EvenNumber - EvenNumber; 

} 

public int Number 

í 

ge t 
{ 

return EvenNumber; 


} 


eldss EvenNumberHandlerCíass 
{ 

public voicl EvenNumber Found (obj ect Onginator, 

OnE venNumberEventArgs E v e nNumb erEventArgs) 

{ 

C ons ole . Wr i t eLine ( EvenNumbe r EventAr g.s . Numbe r ) ; 


\ 

cla.s.s MdinCldss 
{ 

pi;b !. i. c sldtic voicl Main f,1 
{ 

i: ount e r M y C o unter = n e w C o un t e r ( ) ; 

EvenNumbe rHancllerClas s MyEvenNumberHandlerClass ~ new 
Ev e nNumberHandlerC1 a ss () ; 

MyCount e r . OnEvenNumíoe r + - new 

E ven M u mb e r Ha nd 1er (M y E v e n Numb e r H a n el 1 e r C1 a s s . E v e n N umb e r F o un el > ; 
M y C o u í 1 1 e r . C o u n t T o 10 0 í ) ; 


Ei 1 listado 1 5.2 añade una nueva clase llamada OnEvenNumberEvent Args 
que deriva de la clase NLT EventArgs. Implementa un constructor que toma 
un numero entero y lo almacena en una variable privada También expone una 
propiedad de solo lectura llamada Number. que devuelve el valor de la variable 
privada. 

La firma del delegado también ha cambiado para cumplir con la nueva conven¬ 
ción. Ahora acepta dos parámetros de entrada: una referencia al objeto que desen¬ 
cadena el evento y un objeto de tipo OnEvenNumber Event Args. 

Cuando la clase Counter se prepara para desencadenar el evento, antes 
crea un nuevo objeto de tipo OnEvenNumberEventArgs y lo micializa con el 
numero impar. A continuación pasa este objeto al evento como segundo para¬ 
metro. 

La nuev a implementación del método EvenNumber Found examina el se¬ 
gundo parámetro, un objeto de clase OnEvenNumberEventArgs y escribe el 
valor de la propiedad Number del objeto en la consola. 
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Cómo usar descriptores de acceso 
de eventos 


En la implementación general de objetos, hay que tener un campo de eventos 
definido en la clase por cada evento posible que pueda desencadenar la clase. En 
ejemplos como el listado 15.2. en el que la clase sólo desencadena un evento, 
definir un campo de eventos para cada evento no es muy costoso. Sin embargo, 
este sistema es mucho más complicado cuando la clase puede desencadenar uno 
de varios eventos. 

Tome, por ejemplo, una clase de C# que gestiona un componente de la interfaz 
de usuario de Windows. Los componentes normales de la interfaz de usuario de 
Windows pueden recibir uno de los muchos mensajes posibles del sistema opera¬ 
tivo v podríamos querer diseñar nuestra clase para que se envíen a los usuarios de 
la clase, mediante un evento de C#. los mensajes que el componente del interfaz de 
usuario recibe del sistema operativo. Definir un campo de evento en una clase 
para cada posible mensaje de Windows obligaría a la clase a almacenar una gran 
cantidad de campos y haría que tuviera un tamaño enorme. C# admite una forma 
alternativa por la que los eventos pueden definirse como propiedades, en lugar de 
como campos. Las propiedades de eventos funcionan exactamente igual que las 
propiedades de clase estándar, que se implementan con código, en lugar de cam¬ 
pos de datos. A diferencia de una propiedad estándar, una propiedad de evento 
usa las palabras clave add y remove para definir bloques de codigo: 

pub.Lic event EvenNumberHandler OnEvenNumber 

i 

add 

{ 

} 

remove 

{ 

} 

} 

El codigo del bloque de codigo add se invoca cuando un usuario añade un 
nuev o controlador de ev entos al ev ento usando el operador + = . 

La ventaja de usar descriptores de acceso de eventos es que tenemos total 
libertad en lo que respecta al modo en que almacenamos los controladores de 
eventos. En lugar de definir campos separados para cada evento, podemos alma¬ 
cenar una sola lista enlazada o una matriz de controladores y podemos implementar 
el descriptor de acceso de eventos remove para eliminar un controlador de even¬ 
tos de la matriz o de la lista. 

Como en las propiedades estándar, podemos usar la palabra clave de C# valué 
para hacer referencia al controlador de evento que se añade o elimina, como se 
puede v er en la siguiente instrucción: 
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MyCounter.OnEvenNumber += new 

EvenNumberHandler(MyEvenNumberHandlerClass.EvenNumberFound); 

En esta instrucción, se añade al evento OnEvenNumber un nuevo 
EvenNumberHandler objeto. Si implementásemos el evento como una pro¬ 
piedad. el bloque de código add podría usar la palabra clave add para hacer 
referencia al nuevo objeto EvenNumberHandler: 

public event EvenNumberHandler OnEvenNumber 
{ 

add 

{ 

AddToLis t (valué) ; 

} 

r emove 
{ 

RemoveFromList(valué); 


} 

Cuando se usa en descriptores de acceso de eventos, la palabra clave valué 
es una variable de tipo Delegate. 


Cómo usar modificadores de eventos 


Se puede anteponer a una declaración de un evento uno de los siguientes modi¬ 
ficadores: 

• Static 

• Virtual 

• Override 

• Abstract 

Eventos estáticos 

Los eventos modificados con la palabra clave static se comportan de forma 
parecida a los campos estáticos, en el sentido de que. aunque cada copia de una 
clase contiene copias separadas de todos los campos, solo puede haber una copia 
de un miembro estático en un momento dado. Todos los objetos de la clase com¬ 
parten los eventos estáticos. Cuando se les hace referencia, debe ser a través del 
nombre de la clase v no mediante el nombre del objeto, como se aprecia a conti¬ 
nuación: 

public class Counter 

{ 
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public static event EvenNumberHandler OnEvenNumber; 

// . . . 

} 


Counter.OnEvenNumber += new 

EvenNumbe rHandler(MyEvenNumberHandlerCíass.EvenNumberFound) ; 

Como puede ver. debe hacer referencia al evento estático OnEvenNumber 
especificando el nombre de la clase y el nombre del objeto. 

Eventos virtuales 

Los eventos modificados con la palabra clave virtual marcan cualquier 
descriptor de acceso add o remo ve como virtual. Los descriptores de acceso 
virtuales en clases derivadas pueden ser reemplazados. 

Eventos de reemplazo 

Los eventos modificados con la palabra clave override marcan cualquier 
descriptor de acceso add o remove como eventos de reemplazo add o remove 
con el mismo nombre en una clase base. 

Eventos abstractos 

Los eventos modificados con la palabra clave abstract marcan cualquier 
descriptor de acceso add o remove como abstracto. Los descriptores de acceso 
abstractos no proporcionan una implementación propia: en su lugar, un evento de 
reemplazo de una clase derivada proporciona una implementación. 


Resumen 

Las clases pueden desencadenar eventos cuando un programa pide a sus clien¬ 
tes que le avisen de las acciones llevadas a cabo por la clase. Sin eventos, los 
usuarios llaman a un método para realizar una operación, pero en realidad no 
saben lo avanzada que está la operación Imagine, por ejemplo, un método que 
recupera una página Web de un servidor Web. Esa operación consiste en varios 
pasos: 

• Conectar con el servidor Web. 

• Solicitar la página Web. 

• Recuperar la página Web devuelta. 

• Desconectar del servidor Web. 


355 



Es posible diseñar una clase como ésta con eventos que se desencadenen 
cuando comience cada una de estas acciones. Al desencadenar los eventos en 
los pasos críticos del proceso le da pistas a los usuarios de su clase sobre en qué 
parte del proceso se encuentra el código. 

Los invocadores responden a los eventos registrando métodos llamados 
controladores de eventos. Los controladores de eventos se invocan cuando una 
clase desencadena algún evento. Estos métodos se corresponden con la lista de 
parámetros y devuelven un v alor de un método patrón especial llamado delegado. 
Un delegado describe el diseño de un controlador de eventos, indicando qué 
parámetros debe admitir y como debe ser su código dev uelto. 

Los controladores de eventos se instalan usando el operador +=. Los eventos 
se declaran normalmente como campos públicos en una clase y los invocadores 
añaden sus controladores de eventos a la clase creando un nuevo objeto de la clase 
delegado v asignando el objeto al evento usando el operador +=. CU permite 
especificar v arios controladores de ev entos para un solo ev ento y también permite 
usar el operador -= para eliminar un controlador de eventos de un evento. 

C# no obliga a usar un único patrón de diseño para los delegados, pero NET 
Framevvork recomienda un diseño. Usar el diseño recomendado proporciona un 
estándar que. cuando se respeta, puede dar a los delegados una lista de parámetros 
de método: un objeto que especifica los objetos que desencadenan el ev ento y un 
objeto de una clase derivada de la clase System. EventArgs. que contiene los 
argumentos para el evento. 

C# hace que sea muy sencillo implementar eventos en las clases. En el nivel 
más básico, cada ev ento se declara como un campo publico y se pueden gestionar 
tantos eventos como se desee. Si la clase v a a gestionar varios ev entos y el número 
de campos públicos dentro de la clase parece tener una cantidad excesiva de 
código, se pueden escribir descriptores de acceso de eventos que permitan contro¬ 
lar el modo en que la clase gestiona los controladores de eventos. En lugar de 
definir campos públicos para los eventos, los descriptores de acceso de eventos 
permiten definir los eventos como propiedades con bloques de codigo add y 
remove. El bloque de codigo add se invoca cuando se añade un controlador de 
eventos a un evento y el bloque de código remove se invoca cuando se elimina 
un controlador de eventos de un evento. Estos bloques de código se pueden 
implementar almacenando los controladores de eventos en una matriz o en una 
lista para ser usados posteriormente. 

El concepto de C# de ev entos y delegados es un concepto nuevo para la familia 
de lenguajes C Los eventos pueden ser desencadenados en C y C++ usando otros 
mecanismos, pero estos lenguajes no definen palabras clave para hacer que fun¬ 
cionen los eventos. En CU. los eventos y delegados son elementos completamente 
definidos por si mismos y tanto el lenguaje como el compilador tienen compatibi¬ 
lidad integrada para el control de eventos. 

Otra ventaja de usar eventos en CU es que son completamente compatibles 
con el C'LR. lo que significa que se puede preparar un mecanismo de ev ento en 
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C# y desencadenar eventos que se controlen por otro lenguaje NET Como el 
CLR admite eventos en el nivel de tiempo de ejecución, se puede desencadenar 
un evento en C# y controlarlo y procesarlo con otro lenguaje, como Visual Basic 
NET 
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iEl Control 
de excepciones 


16 


Buscar errores y manejarlos adecuadamente es un principio fundamental para 
diseñar software correctamente. En teoría, escribimos el código y cada linea fun¬ 
ciona como pretendemos y los recursos que empleamos siempre están presentes. 
Sin embargo, éste no siempre es el caso en el mundo real. Otros programadores 
(por supuesto, no nosotros) pueden cometer errores, las conexiones de red pueden 
interrumpirse, los servidores de bases de datos pueden dejar de funcionar y los 
archivos de disco pueden no tener los contenidos que las aplicaciones creen que 
contienen. En pocas palabras, el código que se escribe tiene que ser capaz de 
detectar errores como estos y responder adecuadamente. 

Los mecanismos para informar de errores son tan diversos como los propios 
errores. Algunos métodos pueden estar diseñados para devolver un valor booleano 
que indican el éxito o el fracaso de un método. Otros métodos pueden escribir 
errores en un fichero de registro o una base de datos de algún tipo. La variedad de 
modelos de presentación de errores nos indica que el código que escribamos para 
controlar los errores debe ser bastante consistente. Cada método puede informar 
de un error de un modo distinto, lo que significa que la aplicación estará repleta 
de gran cantidad de código necesario para detectar los diferentes tipos de errores 
de las diferentes llamadas al método. 

NET Framework proporciona un mecanismo estándar, llamado control de 
excepciones estructurado (SEH). para informar de errores. Este mecanismo de- 
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pende de las excepciones para indicar los fallos. Las excepciones son clases que 
describen un error. NET Framework las usa para informar de errores y podemos 
utilizarlas en nuestro codigo. Puede escribir código que busque excepciones gene¬ 
radas por cualquier fragmento de código, tanto si procede del CLR como si proce¬ 
de de nuestro propio código y podemos ocuparnos de la excepción generada 
adecuadamente Usando SEH. solo necesitamos crear un diseño de control de 
errores para nuestro código. 

Esta metodología unificada del proceso de errores también es crucial para 
permitir la programación NET multilingüe. Al diseñar todo nuestro código usan¬ 
do SEH. podemos mezclar y comparar código (por ejemplo C'#. C++ o VB NET). 
sin peligro alguno y fácilmente. Como premio por seguir las reglas del SEH. 

NET Framework garantiza que todos los errores serán expuestos y controlados 
convenientemente en los diferentes lenguajes. 

El proceso de detección y gestión de excepciones en el código de C# es senci¬ 
llo. Se deben identificar tres bloques de código cuando se trabaja con excepcio¬ 
nes: 


♦ El bloque de código que debe usar el procesamiento de excepciones 

♦ Un bloque de código que se ejecuta si se encuentra una excepción mientras 
se procesa el primer bloque de código 

♦ Un bloque de código opcional que se ejecuta después de que se procese la 
excepción 

En CU. la generación de una excepción recibe el nombre de iniciación Je una 
excepción. El proceso de informar de que se ha iniciado una excepción recibe el 
nombre de capturar una excepción. El fragmento de código que se ejecuta des¬ 
pués de que se haya procesado la excepción es el bloque finally. En este 
capítulo veremos como se usan estos constructores en CU. También estudiaremos 
a los miembros de la jerarquía de las excepciones. 


NOTA: Un debate largo y recurrente de la comunidad de usuarios de soft¬ 
ware orientado a objetos es si las excepciones deberían usarse en todos los 
errores (incluyendo los errores que uno espera que ocurran frecuentemente) 
o sólo para los errores graves (los conocidos como errores de excepción, 
que sólo ocurren cuando un recurso falla inesperadamente). El punto crucial 
de este debate es el relativamente importante encabezado necesario para 
iniciar y atrapar excepciones, encabezado que podemos evitar mediante el 
uso de otro método de control, como los códigos de devolución. La respues¬ 
ta de .NET Framework a este conflicto es el uso del control de excepciones 
estructurado para todos los errores porque permite garantizar que todos los 
recursos se liberan adecuadamente cuando se produce un error. Esto es 
propio del consenso actual de este reñido debate. La investigación exhaus- 
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tiva (principalmente por parte de la comunidad de usuarios de C++) ha 
llegado a la conclusión de que evitar la pérdida de recursos sin excepciones 
es prácticamente imposible. Por supuesto, C# evita la pérdida de memoria 
con la recogida de elementos no utilizados, pero todavía necesitamos un 
mecanismo para evitar las pérdidas de recursos de los varios tipos de pun¬ 
teros de operaciones del sistema. 

Como en todas las instrucciones de diseño, usar excepciones indiscrimi¬ 
nadamente para todos los errores supone un uso excesivo de recursos. Cuando 
el error es local para un bloque de código, puede ser más apropiado usar 
códigos de devolución de error. Con frecuencia vemos este enfoque cuando 
se implementa una validación de formularios. Éste es un cambio aceptable 
porque los errores de validación suelen estar localizados en el formulario 
que recoge la entrada. En otras palabras, cuando ocurre un error de valida¬ 
ción, se presenta en pantalla un mensaje y pedimos al usuario que vuelva a 
introducir correctamente la información requerida. Como el error y el códi¬ 
go controlador están en el mismo bloque, controlar la pérdida de recursos 
es sencillo. Otro ejemplo es controlar una condición de fin de archivo cuan¬ 
do se está leyendo un archivo. Esta condición puede ser controlada fácil¬ 
mente sin usar el encabezado de excepciones requerido. De nuevo, la 
condición de error se controla completamente dentro del bloque de código 
donde ocurre el error. Cuando observe que se realizan llamadas al código 
fuera del bloque de código donde ocurre el error, debe tender a procesar los 
errores usando SEH. 


Cómo especificar el procesamiento 
de excepciones 


La palabra clave de C# try especifica que hay un bloque de código que debe 
buscar cualquier excepción iniciada mientras se está ejecutando el codigo. Traba¬ 
jar con la palabra clave try es sencillo. Use la palabra clave try seguida de una 
llave de apertura, de las instrucciones en las que se deben buscar excepciones 
mientras se ejecutan y termine con una llave de cierre: 

try 


// coloque aquí las instrucciones 

} 

Si se inicia una instrucción mientras se esta ejecutando cualquiera de las ins¬ 
trucciones del bloque try. se puede capturar la excepción en el código y ocupar¬ 
se de ella adecuadamente. 
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Cómo capturar excepciones 


Si se usa la palabra clave try para especificar que desea ser informado sobre 
las excepciones iniciadas, es necesario escribir código que atrape la excepción y 
se ocupe de los errores que envía el código. 

Para indicar el código que debe ejecutarse cuando se atrape una excepción se 
usa la palabra clave de C# catch después de un bloque try. La palabra clave 
catch funciona de forma parecida a la palabra clave try. 


Cómo usar la palabra clave try 


La forma más simple del bloque de código catch atrapa todas las excepcio¬ 
nes iniciadas por el código en el anterior bloque try. El bloque catch tiene la 
misma estructura que el bloque try, como se puede apreciar en el siguiente 
ejemplo: 

try 


// coloque aquí las instrucciones 


catch 

{ 

// coloque aquí las instrucciones 

} 

Las instrucciones del bloque catch se ejecutan si se inicia una excepción 
desde el bloque try. 

Si ninguna de las instrucciones del bloque try inicia una excepción, entonces 
no se ejecuta nada del código del bloque catch. 


Cómo atrapar clases específicas de excepciones 

También se puede escribir un bloque catch que controle una clase específica 
de excepción iniciada por una de las instrucciones del bloque try. Esta forma del 
bloque de código catch usa la siguiente sintaxis: 

• La palabra clave catch 

• Un paréntesis de apertura 

• La clase de excepción que desea controlar 

• Un identificador de variable para la excepción 

• Un paréntesis de cierre 

• Una llave de apertura 
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• Las instrucciones que deben ejecutarse cuando se inicia una excepción del 
tipo especificado desde el anterior bloque try 

• Una llave de cierre 
Observe el siguiente código: 

try 

í 

// coloque aquí las instrucciones 

} 

catch(Exception thrownException) 

{ 

// coloque aqui las instrucciones 


El bloque catch de este ejemplo atrapa excepciones de tipo Exception 
que inician el anterior bloque try. Define una variable del tipo Exception 
llamada ThrownExcept ion. La variable ThrownExcept ion puede usarse 
en el código del bloque catch para obtener más información sobre la excepción 
iniciada. 

El código del bloque try puede iniciar diferentes clases de excepciones y quere¬ 
mos controlar cada una de las diferentes clases. C# permite especificar varios blo¬ 
ques catch. cada uno de los cuales controla una clase de error específica: 

try 

{ 

// coloque aquí las instrucciones 

) 

catch(Exception ThrownException) 

{ 

// Bloque catch 1 

} 

catch(Exception ThrownException2) 

{ 

// Bloque catch 2 

} 

En este ejemplo, se revisa el código del bloque try en busca de excepciones 
iniciadas. Si el CLR descubre que el codigo del bloque try inicia alguna excep¬ 
ción. examina la clase de la excepción y ejecuta el bloque catch adecuado. Si la 
excepción iniciada es un objeto de clase Exception. se ejecuta el codigo del 
Bloque catch 1. Si la excepción iniciada es un objeto de alguna otra clase, 
no se ejecuta ninguno de los bloques. 

También se puede añadir un bloque catch genérico a la lista de bloques de 
código catch. como en el siguiente ejemplo: 

try 

{ 


// coloque aquí las instrucciones 



} 

catch(Exception ThrownException) 
{ 

// Bloque catch 1 

} 

catch 


// Bloque catch 2 

} 


En este caso, se revisa el código del bloque try en busca de excepciones. Si la 
excepción iniciada es un objeto de clase Exception. se ejecuta el código de 
Bloque catch 1. Si la excepción iniciada es un objeto de alguna otra clase, 
se ejecuta el codigo del bloque genérico catch (Bloque catch 2). 

Cómo liberar recursos después 
de una excepción 

Los bloques catch pueden ir seguidos por bloque de código. Este bloque de 
codigo se ejecuta después de que se procese una excepción y cuando no ocurre 
ninguna excepción. Si se quiere ejecutar este código, se puede escribir un bloque 
finally. La palabra clave de C# finally especifica que hay un bloque de 
código que debe ejecutarse después de que se ejecute un bloque de código try. 
Un bloque de código finally tiene el mismo formato que los bloques try: 

finally 

{ 

// coloque aquí las instrucciones 

} 

El bloque de código finally es un buen sitio donde liberar recursos a los 
que se había colocado en el método con anterioridad. Suponga, por ejemplo, que 
estamos escribiendo un método que abre tres archivos. Si encerramos el codigo de 
acceso a archivos en un bloque try. podremos atrapar excepciones relacionadas 
con la apertura, lectura o escritura de esos archivos. Sin embargo, al final del 
código, querremos cerrar los tres archivos, aunque se haya iniciado una excep¬ 
ción. Probablemente queramos colocar las instrucciones de cierre de archivos en 
un bloque finally y podremos estructurar el código como se indica a continua¬ 
ción: 

try 

{ 

// abrir archivos 

// leer archivos 

) 

catch 

{ 

// atrapar excepciones 
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} 

fina11 y 
{ 

// cerrar archivos 


El compilador de C# permite definir un bloque finally sin ningún bloque 
catch. Se puede escribir un bloque f inally inmediatamente después de un 
bloque try. 

La clase exception 

Todas las excepciones iniciadas por NET Framework son clases derivadas de 
la clase System. Exception. La tabla 16.1 describe algunos miembros útiles 
de esta clase. 

Tabla 16.1. Miembros de la clase System.Exception Class 


Miembro 

Descripción 

HelpLink 

Un vínculo al archivo de ayuda que proporciona 
más información sobre la excepción 

Message 

El texto que se ha proporcionado, normalmente 
como parte del constructor de la excepción, para 
describir la condición del error 

Source 

El nombre de la aplicación u objeto que provocó la 
excepción 

StackTrace 

Una lista de las llamadas al método en la pila 

TargetSite 

El nombre del método que inició la excepción 


Introducción a las excepciones definidas 
por .NET Framework 


.NET Framework define varias excepciones que pueden iniciarse cuando se 
encuentran ciertos errores en el código de C# o en los métodos que se pueden 
invocar. Todas estas excepciones son excepciones estándar de NET y pueden ser 
atrapadas usando un bloque catch de C#. 

Cada una de las excepciones de NET se define en el espacio de nombre System 
de NET. Los siguientes apartados describen algunas de las excepciones mas 
comunes. Estas excepciones son sólo una pequeña parte de todas las que ha\ 
definidas en la biblioteca de clases base de NET Framework. 
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OutOfMemoryException 

El CLR inicia la excepción OutOfMemoryException cuando agota su 
memoria. Si el codigo intenta crear un objeto usando el operador new y el CLR 
no dispone de suficiente memoria para ello, el CLR inicia la excepción 

OutOfMemoryException. mostrada en el listado 16.1. 

Listado 16.1. Excepción OutOfMemoryException 

using System; 

class MainClass 
{ 

public static void Main() 

{ 

int [] LargeArray; 

t r y 
í 

LargeArray = new int [2000000000]; 

} 

catch (OutOfMemoryException) 

{ 

Consolé.WriteLine("The CLR is out of memory."); 

I 



El codigo del listado 16.1 intenta asignar un espacio a una matriz de dos mil 
millones de números enteros. Dado que un número entero requiere cuatro bvtes de 
memoria, se necesitan ocho mil millones de bvtes para contener una matriz de este 
tamaño. Es bastante probable que su ordenador no disponga de esta cantidad de 
memoria y de que la asignación falle. El codigo encierra a la asignación en un 
bloque try y define un bloque catch para que controle cualquier excepción 
OutOfMemoryException iniciada por el CLR. 


NOTA: El código del listado 16.1 no escribe un identificador para la ex¬ 
cepción del bloque catch. Esta sintaxis (en la que se especifica la clase de 
una excepción pero no se le da nombre) es válida. Funciona perfectamente 
cuando se quiere atrapar una clase de excepciones pero no se necesita infor¬ 
mación del propio objeto específico de la excepción. 


StackOverflowException 

El CLR inicia la excepción StackOverflowException cuando agota el 
espacio de la pila. El CLR gestiona una estructura de datos llamada stock, que 
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registra los métodos que han sido llamados y el orden en el que fueron llamados. 
El CLR tiene una cantidad limitada de espacio de pila disponible y si se llena, se 
inicia la excepción. El listado 16.2 muestra la excepción StackOverflow¬ 
Exception. 

Listado 16.2. Excepción StackOverflowException 
using System; 

class MainClass 

í 

public static void Main() 

{ 

t r y 
{ 

Recursive ( ) ; 

} 

catch(StackOverflowException) 

{ 

Consolé .WriteLine ( "The CLR is out of stack space . ,f ) ; 

} 

} 


public static void Recursive() 

{ 

Recursive () ; 

} 

} 

El código del listado 16.2 implementa un método llamado Recursive ( ) . 
que se llama a sí mismo antes de regresar. Este método es llamado por el método 
Main ( ) y con el tiempo, hace que el CLR agote su espacio de pila porque el 
método Recursive ( ) nunca regresa. El método Main ( ) llama a 
Recursive ( ) . que a su vez llama a Recursive ( ) . que a su vez llama a 
Recursive ( ) y así sucesivamente. A la larga, el CLR se quedará sin espacio 
de pila e iniciara la excepción StackOverf lowException. 

NullReferenceException 

En este ejemplo, el compilador atrapa un intento de eliminar la referencia de 
un objeto nuil. El listado 16.3 muestra la excepción NullReference¬ 
Exception. 

Listado 16.3. Excepción NullReferenceException 

using System; 

class MyClass 
{ 

public int Valué; 
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class MamClass 


public static void Main f) 

{ 

t r y 
{ 

MyObject = new MyClass{); 

MyObject - nuil; 

MyObject.Valué = 12 3; 

// espere a que el usuario reconozca los resultados 
Console.WnteLine ("Hit Enter to termínate..."); 
Consolé.Read ( ) ; 

} 

cat ch (Nu11 Re f e r enceException) 

{ 

Consolé .WriteLine ( "Cannot reference a nuil object. . " 

//espere a que el usuario reconozca los resultados 
Consolé . Read (1 ; 


} 

} 

El código del listado 16.3 declara una variable de objeto de tipo MyClass y 
asigna a la variable el valor de nuil (Si no se usa la instrucción new. sino que 
sólo se declara una variable de objeto de tipoMyClass. el compilador emitirá el 
siguiente mensaje de error cuando se compile. "Uso de la variable local no asigna¬ 
da MyOb j ect .") A continuación intentará trabajar con el campo publico Value 
del objeto, lo que no está permitido porque no se puede hacer referencia a objetos 
nuil. El CLR atrapa este error e inicia la excepción NullReference- 
Exception. 

TypelnitializationException 

El CLR inicia la excepción TypelnitializationException cuando 
una clase define un constructor estático y el constructor inicia una excepción. Si 
no hay bloques catch en el constructor para atrapar la excepción, el CLR inicia 
una excepción TypelnitializationException. 

InvalidCastExpression 

El CLR inicia la excepción InvalidCastExpression si falla una con¬ 
versión explícita. Esto puede ocurrir en contextos de interfaz. El listado 16.4 
muestra una excepción InvalidCastExpression. 
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Listado 16.4. Excepción invalidCastException 

using System; 

class MainClass 
{ 

pub lie static vo i el Mam( ) 


t ry 
{ 

MainClass MyObject = new MainClass(); 
IFormattable Formattable; 

Formattable = (I Forma11ab1e)MyObject; 

// espere a que el usuario reconozca los re.su i t 
Consolé.WriteLine("Hit Enter to termínate. 
Consolé.Read(); 


catch(InvalidCastException) 

í 

Consolé .WriteLine ( "MyObj ect. does not ímpleruent t.he 
IFormattable interface."); 

// espere a que el usuario reconozca los resultados 
Consolé.Readí); 


} 

El código del listado 16 4 usa un operador de conversión de tipo explícito para 
obtener una referencia a una interfaz .NET llamada IFormattable. Como la 
clase Ma i nC las s no i mpl ementa la interfaz IFormattable. la operación de 
conversión explícita falla y el CLR inicia la excepción Inval IdCast- 
E c e p t i o n. 

ArrayTypeMismatchException 

El CLR inicia la excepción ArrayTypeMi siria t;chE:-:cept ion cuando el 
código intenta almacenar un elemento en una matriz cuno tipo no coincide con el 
tipo del elemento. 

IndexOutOfRangeException 

El CLR inicia la excepción IndexOutOfRangeException cuando el codigo 
intenta almacenar un elemento en una matriz empleando un índice de elemento 
que está fuera del rango de la matriz. El listado 16.5 describe la excepción 

IndexOutOfRangeException. 
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Listado 16.5. Excepción indexOutOf RangeException 

usmg System; 

class MainClass 
{ 

public static void Main() 

{ 

t r y 
{ 

int [] IntegerArray = new int [5]; 

IntegerArray[10] = 123; 

// espere a que el usuario reconozca los resultados 
Consolé.WriteLine("Hit Enter to termínate..."); 

Consolé.Read(); 

) 

catch(IndexOutOfRangeException) 

{ 

Consolé.WriteLine("An invalid element Índex access was 
attempted."); 

// espere a que el usuario reconozca los resultados 
Console.Read { ) ; 

} 


} 

El código del listado 16.5 crea una matriz con cinco elementos y a continua¬ 
ción intenta asignar un valor al elemento 10 de la matriz. Como el índice 10 está 
fuera del rango de la matriz de números enteros, el CLR inicia la excepción 

IndexOutOfRangeException. 

DivideByZeroException 

El CLR inicia la excepción DivideByZeroException cuando el código 
intenta realizar una operación que da como resultado una división entre cero. 

OverflowException 

El CLR inicia la excepción OverflowException cuando una operación 
matemática guardada por el operador de C# checked da como resultado un 
desbordamiento. El listado 16.6 muestra la excepción OverflowException. 

Listado 16.6. Excepción OverflowException 


using System; 
class MainClass 
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{ 

public static void Main() 

{ 

t r y 
{ 

checked 

{ 

mt Integerl; 
int Int eger2; 
mt Sum; 

Integerl = 2000000000; 
Integer2 = 2000000000; 

Sum = Integerl + Integer2; 

} 


// espere a que el usuario reconozca los resultados 
Consolé.WriteLine("Hit Enter to termínate..."); 
Consolé.Read{); 

} 

catch(OverflowException) 

í 

Consolé.WriteLine("A mathematical operation caused an 
ove r i 1ow.") ; 

// espere a que el usuario reconozca los resultados 
Consolé.Read(); 



El código del listado 16.6 suma dos números enteros, cada uno con un valor de 
dos mil millones. El resultado, cuatro mil millones, se asigna a un tercer numero 
entero. 

El problema es que el resultado de la suma es mayor que el valor máximo que 
se puede asignar a un número entero de C# y se inicia una excepción de desborda¬ 
miento matemático. 

Cómo trabajar con sus propias 
excepciones 


Puede definir sus propias excepciones y usarlas en su codigo del mismo modo 
que baria con una excepción definida por NET Framework Esta consistencia en 
el diseño le permite escribir bloques catch que funcionen con cualquier excep¬ 
ción que pueda iniciar cualquier fragmento de codigo. tanto si el codigo pertenece 
a NET Framework. como si pertenece a una de sus propias clases o a un ensam¬ 
blado que se ejecuta en tiempo de ejecución. 
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Cómo definir sus propias excepciones 


NET Framework declara una clase llamada System. Exception. que sir¬ 
ve como clase base para todas las excepciones de .NET Framework. Las clases 
predefinidas del entorno común de ejecución se derivan de System. 
SystemEzception. que a su vez deriva de System. Exception. La ex¬ 
cepción a esta regla son las excepciones DivideByZeroException. 
Not F.i niteNumberException y Overf lowException. que derivan de 
una clase llamada S y s t em . Ar i t hme t i cEx cep t i o n. que deriva de 
System. SystemException. Cualquier clase de excepción que defina debe 
derivar de System. Appl i ca t i onExcept ion. que también deriva de 
System.Exception. 

La clase System. Exception contiene cuatro propiedades de sólo lectura 
que el codigo de los bloques catch puede usar para obtener más información 
sobre la excepción que se ha iniciado: 

• La propiedad Message contiene una descripción de la causa de la excep¬ 
ción. 

• La propiedad InnerException contiene la excepción que ha provoca¬ 
do que se inicie la excepción actual. Esta propiedad puede ser nuil, lo que 
indicaría que no hay ninguna excepción interior disponible. Si 
InnerExcept ion no es nuil, hace referencia al objeto de excepción que 
se ha iniciado y que provocó que se iniciase la excepción actual. Un bloque 
catch puede atrapar una excepción e iniciar otra diferente. En ese caso, 
la propiedad InnerException puede contener una referencia al objeto 
de excepción original atrapado por el bloque catch. 

• La propiedad StackTrace contiene una cadena que muestra la pila de 
llamadas de método que estaba en vías de ejecución cuando se inicio 
la excepción. En última instancia, este rastro de pila puede contener todo 
el recorrido hasta la llamada al método Main ( ) de la aplicación del 
CLR 

• La propiedad TargetSite contiene el método que ha iniciado la excep¬ 
ción. 

Algunas de estas propiedades pueden especificarse en uno de los constructores 
de la clase System . Exception: 

public Exception(string message); 

pubiic Exception(string message, Exception innerException); 

Las excepciones definidas por el usuario pueden llamar al constructor de clase 
base en su constructor de modo que se pueden asignar valores a las propiedades, 
como muestra el siguiente codigo: 
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using System; 


cías s MyException : ApplicationException 

{ 

public MyException() : base("This ís my exception message.") 

{ 

} 

} 

Este código define una clase llamada MyExcept ion. que deriva de la clase 
Applicat ionExcept ion. Su constructor usa la palabra clave base para 
llamar al constructor de la clase base. La propiedad Message de la clase recibe 
el valor This is my exception message. 

Cómo iniciar sus excepciones 

Puede iniciar sus propias excepciones mediante la palabra clave de C # throw. 
La palabra clave throw debe ir seguida por una expresión que evalúa un objeto 
de clase System. Exception o una clase derivada de System. Exception. 
Observe el código del listado 16.7. 

Listado 16.7. Cómo iniciar sus propias excepciones 

using System; 

class MyException : ApplicationException 

{ 

public MyException() : base ("This is my exception message.") 

{ 

} 

} 


class MainClass 

í 

public static voicl Mam () 

{ 

try 

{ 

MainClass MyObject - new MainClass(); 

MyObject.ThrowException(); 

// espere a que el usuario reconozca los resultados 
Consolé.WriteLine("Hit Enter to termínate..."); 
Consolé.Read ( ); 

} 

catch(MyException CaughtException) 

{ 

Consolé.WriteLine (CaughtException.Message) ; 
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// espere a que el usuario reconozca los resultados 
Consolé.Read ( ) ; 



public void ThrowException() 
{ 

throw new MyException() ; 

} 


El código del listado 16-7 declara una clase new llamada MyException. 
que deriva de la clase base ApplicationException definida por NET 
Framework. 

La clase Ma inClass contiene un método llamado ThrowException. que 
inicia un nuevo objeto de tipo MyException. El método es invocado por el 
método Main ( ) . que encierra la llamada en un bloque try. El método Main { ) 
también contiene un bloque catch. cuya implementación escribe el mensaje de 
la excepción en la consola. Como el mensaje se estableció cuando se construyó el 
objeto de la clase MyException. está disponible y se puede escribir. Si se 
compila y ejecuta el listado 16.7 se escribe lo siguiente en la consola: 

This is my exception message. 

Cómo usar excepciones en constructores 
y propiedades 

Algunos constructores de C# contienen código que se puede ejecutar, pero no 
pueden devolver un valor que indique el éxito o fracaso del código que se está 
ejecutando. Los constructores de clase y los descriptores de acceso de propieda¬ 
des set son un ejemplo claro. Iniciar excepciones es un buen modo de informar 
de errores de bloques de codigo como éstos. 

En un capítulo anterior examinamos una clase que implementaba un punto en 
la pantalla. La clase tenía propiedades que representaban las coordenadas .v e y 
del punto y los descriptores de acceso set para las propiedades garantizaban que 
el valor era válido antes de que se almacenara realmente. El problema con el 
código del listado 9.1 es que no hay un informe de errores en caso de que se 
proporcione un valor que este fuera de los límites permitidos. El listado 16.8 es 
una versión mejorada del listado 9.1 porque añade control de excepciones para 
informar de coordenadas que están fuera de los limites permitidos. 

Listado 16.8. Cómo iniciar excepciones desde descriptores de acceso de propiedades 

usmg System; 

public cías s Coordínate Out Oí Range Ex c eption : 

App1icationException 
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base ("The supplied 


{ 

public CoordinateOutOfRangeException() 
coordínate is out of range.") 

{ 

} 

} 


public class Point 

{ 

prívate int XCoordinate; 
prívate int YCoordinate; 

public int X 

{ 

ge t 

{ 

return XCoordinate; 

} 

set 

{ 

i f ( (v a 1 u e > - 0) & & (valué < 6 40)) 

XCoordinate = valué; 
e ls e 

throw new CoordinateOutOfRangeException () ; 

} 

} 

public int Y 

{ 

get 

{ 

return YCoordinate; 

} 

set 

{ 

i f ( (valué >- 0) Se Se (valué < 480)) 

YCoordinate = valué; 
e 1 s e 

throw new CoordinateOutOfRangeException(); 



public static void Main() 

{ 

Point MyPoint = new Point (); 

t ry 

{ 

MyPoint.X = 100; 

MyPoint.Y = 200; 

Consolé .Wr i teLme ( " ( { 0 } , { 1} ) ", MyPoint .X, MyPoint .Y) ; 

MyPoint. X = 1500; 

MyPoint.Y = 600; 
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Consolé . Wri teLi ne ("({ 0 } , {i})”, MyPoint . X, MyPomt . Y) ; 


// espere a que el usuario reconozca los resultados 
Console.Writ.eTane ("Hit Enter to termínate..."); 

C o n s o ] e . P e a d ( ) ; 

} 

natohíC oordin a t eOu tOf RangeExc ept i on CaughtExcept i on ) 

I 

Cons ole . Wr i telii ne (Caught Except i on . Me s s age ) ; 

// espere a que el usuario reconozca los resultados 
C o n s o 1 e . P e a el ( ] ; 


Caf r:h 
{ 

C on s o ie.Wri teL me ( "An unexpected except i on was 
caught . ") ; 

// es p ere a que el usuario reconozca los resultado s 
C o n s o 1 e . P e a d í ) ; 


} 

1 

El código del listado 16.8 comprueba el valor de ios descriptores de acceso de 
la propiedad set para garantizar que el valor proporcionado está dentro de los 
límites validos. En caso contrario, se inicia una excepción. La asignación del 
primer punto tiene éxito ya que los dos valores están dentro de los límites validos. 
Sin embargo, el segundo punto no tiene éxito, ya que la coordenada x está fuera de 
los limites válidos. Este valor fuera de los límites validos hace que se inicie un 
objeto de clase CoordinateOutOfRangeException. 

Si se compila y ejecuta el listado 16.8 se escribe lo siguiente en la consola: 

( 100 , 200 ) 

The supplied coordínate is out of range. 


Resumen 


NET Eramework usa las excepciones para informar de diferentes errores a las 
aplicaciones NET El lenguaje C# admite perfectamente el tratamiento de las 
excepciones y permite al usuario definir sus propias excepciones, además de tra¬ 
bajar con las excepciones definidas por NET Framework. El codigo de C# puede 
iniciar y atrapar excepciones. También puede atrapar excepciones iniciadas por 
NET Framework. 

La ventaja de usar excepciones reside en que no es necesario comprobar cada 
llamada de método en busca de un error. Se puede encerrar un grupo de llamadas 
de método en un bloque try y se puede escribir código como si cada llamada de 


376 



método del bloque tuviera éxito. Esto hace que el codigo del bloque try sea 
mucho más limpio porque no necesita ninguna comprobación de cirores entre 
líneas. Cualquier excepción iniciada desde el codigo del bloque try es gestiona¬ 
da en un bloque catch. 
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17 


Cómo 


trabajar 
con atributos 


Los capítulos anteriores estaban dedicados a las palabras clave que definen el 
comportamiento de una clase y sus miembros. Por ejemplo, las palabras clave 
public. prívate, protected e internal definen la accesibilidad de la 
declaración para otras clases del código. Estos modificadores están implementados 
por palabras clave predefinidas cun o significado está integrado en el lenguaje C# 
y no puede ser cambiado. 

CU también permite mejorar las declaraciones de clase y de miembro de clase 
mediante información que es interpretada por otras clases de C# en tiempo real. 
Esta información se especifica usando un constructor llamado atributo. Los atribu¬ 
tos permiten incluir directivas en las clases y en sus miembros. El comportamien¬ 
to del atributo se define por el código que escribimos o por el codigo que 
proporciona NET Framework. Los atributos permiten ampliar el lenguaje C.# 
mediante la escritura de clases de atributo que mejoran el comportamiento de 
otras clases cuando se ejecuta el código, aunque escribamos la clase de 
implementación de atributo antes de que los otros usuarios apliquen el atributo a 
sus propias clases. 

Al compilar aplicaciones, la información del atributo que se añade es enviada 
a los metadatos del ensamblado, lo que permite que otras aplicaciones o herra¬ 
mientas vean que se está usando el atributo. Mediante el desensamblador IL 
(1LDASM) o las clases del espacio de nombres System. Ref lection se pue- 
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de comprobar fácilmente que atributos se han añadido a las secciones de codigo y 
se puede determinar si son útiles. En C#. se pueden usar dos tipos de atributo: los 
que están integrados en el lenguaje y los atributos personalizados, que podemos 
crear. En la primera parte de este capítulo, aprenderemos a usar atributos y exa¬ 
minaremos algunos de los atributos integrados que nos ofrece C#. En la segunda 
parte, aprenderemos a escribir atributos personalizados y el modo en que las 
aplicaciones pueden sacar partido de estos atributos. 


Atributos 

C# permite que los atributos se antepongan a los siguientes constructores de 

C#: 

• Clases. 

• Miembros de clase, incluyendo constantes, campos, métodos, propiedades, 
eventos, indizadores. sobrecargas de operador, constructores y destructo¬ 
res. 

• Estructuras. 

• Interfaces. 

• Miembros de interfaces, incluyendo métodos, propiedades, eventos e 
indizadores. 

• Enumeraciones y miembros de enumeraciones. 

• Delegados. 

Para especificar un atributo en el código se escribe su nombre entre corchetes. 
La especificación de atributo debe aparecer antes de la declaración en la que se 
debe aplicar el atributo Los atributos más simples pueden tener este aspecto: 

[MyAttribute] 

Un buen ejemplo de un atributo simple es el modelo de subprocesos que se usa 
para crear una aplicación de consola en C#. Observe en el siguiente fragmento de 
código el atributo [ STAThread ] aplicado a la función Main ( ) . Este atributo 
indica al compilador que la función Mal n ( ) debe introducir un apartamento de 
un único subproceso (STA) COM antes de que se ejecute algún código basado en 
COM 


// sumiría r y > 

// El punto de entrada principal de la aplicación. 
// </s umma ry > 

STAThread J 

static void Main(string[] args ) 
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// 

// TODO: Añada el codigo para iniciar la aplicación aquí 
// 


) 

También se puede anteponer a un atributo un modificador que defina el ele¬ 
mento de C# al que se aplica el atributo. El modificador de atributo se escribe 
antes del nombre del atributo y va seguido de dos puntos. Esto recibe el nombre de 
enlazar un atributo. La tabla 17.1 enumera los tipos de declaraciones y los ele¬ 
mentos a los que hace referencia para los atributos específicos. Los elementos a 
los que las clases de atributo hacen referencia están predefinidos: por ejemplo, si 
una clase NET contiene una clase de atributo que solo hace referencia a enume¬ 
raciones. el atributo sólo puede ser usado para enumeraciones y no puede aplicar¬ 
se a otros constructores del código C#. como clases y estructuras. Más adelante 
aprenderá a especificar los destinos de los atributos para sus clases de atributo 
personalizadas. 


Tabla 17.1. Listado de destinos de atributos 


Declaración 

Destino 

Assembly 

Assembly 

Module 

Module 

Class 

Type 

Struct 

Type 

Interface 

Type 

Enum 

Type 

Delegate 

Type (por defecto) o Return Valué 

Method 

Method (por defecto) o Return Valué 

Parameter 

Param 

Field 

Field 

Property - Indexer 

Property 

Property - Get Accessor Method (por defecto) o Return Valué 

Property - Set Accessor Method (por defecto), Param or Return Valué 

Event - Field 

Event (por defecto), Field o Method 

Event - Property 

Event (por defecto), Property 

Event - Add 

Method (por defecto) o Param 

Event - Remove 

Method (por defecto) o Param 
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Por ejemplo, para enlazar explícitamente un atributo a un método, se debe 
escribir algo parecido a esto: 


[me thod:MyAt tribute] 
int MyMethod{) 

{ 

} 


Los modificadores de atributo son útiles en las situaciones en las que su enlace 
puede ser ambiguo, como muestra el siguiente ejemplo: 

[MyAttribut e ] 
i n t M y M e t h o d f) 

{ 

} 

En realidad, este ejemplo no es muy aclaratorio. ¿Se aplica el atributo 
MyAttribute al método o a su tipo devuelto 9 Si se especifica explícitamente el 
enlace, como se muestra en el anterior ejemplo, se indica al compilador de C# que 
el atributo se aplica a todo el método. En el ejemplo en el que el atributo 
[ STAThread ] se aplica a la función Main ( ) cuando se crea una aplicación de 
consola, se puede hacer la siguiente modificación para hacer más evidente el 
enlace: 

/// ••summary> 

/// El punto de entrada principal de la aplicación. 

/// <'/summary> 

[method: STAThread| 

s t a t i o vo i d Ma : n. ( s t r i ng [ j a r gs ) 

{ 

// 

// TODO: Añada el codigo para iniciar la aplicación aquí 
// 

} 

Algunos atributos están construidos para aceptar parámetros. Los parámetros 
de atributo siguen al nombre del atributo y están entre paréntesis Los paréntesis 
están a su vez entre corchetes. Un atributo con un parámetro puede tener este 
aspecto: 

[MyAttribute(Parameter)] 

Ahora que tiene un conocimiento básico de la sintaxis de los atributos, pode¬ 
mos examinar las clases de atributo integradas que ofrece .NET. Observe que las 
clases de atributos funcionan en todos los lenguajes, de modo que. aunque escriba 
atributos para los tipos de CU. la información de atributo puede ser usada por 
Visual Basic NET. JScnpt NET y todos los lenguajes orientados al entorno 
común de ejecución (CLR). El objetivo del uso de atributos es aumentar la 
funcionalidad del lenguaje. 
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Cómo trabajar con atributos de .NET 
Framework 


NET Framework proporciona cientos de atributos predefinidos integrados. 
No son fáciles de encontrar, ya que el SDK no proporciona una lista con cada 
atributo en orden alfabético. Dependiendo de las clases que estemos usando, los 
atributos pueden derivar de la clase System. Attribute y estos atributos 
pueden ser objetos específicos. Por ejemplo, cuando se trabaja con la función de 
NET Framework que permite que el código .NET interactúe con el código here¬ 
dado COM (lo que se conoce como ínteroperabilidad COM). se pueden emplear 
sobre los modificadores más de 20 clases de atributos, desde el atributo 
ComAliasName hasta el atributo TypeLibType. El siguiente código muestra 
el atributo DllImportAttribute y le da una idea de cómo llamar a métodos 
externos en las DLL de Win32 desde CU. 

ñamespace System.Runtime.InteropServices 
{ 

[AttributeUsage(AttributeTargets.Method)] 
public class DllImportAttribute: System.Attribute 
{ 

public DllImportAttribute(string dllName) (...) 

public CallingConvention CallingConvention; 

public CharSet CharSet; 

public string EntryPoint; 

public bool ExactSpelling; 

public bool PreserveSig; 

public bool SetLastError; 

public string Valué { get {...} } 

} 

} 


Sin atributos, no sería posible informar al compilador de C# del modo en el 
que pretendemos usar un método específico en una DLL externa y si el lenguaje 
CU incluyese esta funcionalidad en el lenguaje base, no sería lo suficientemente 
genérica como para poder ejecutarse en otras plataformas. Con la posibilidad de 
llamar a componentes Win32 a través de todas las plataformas, se obtiene control 
sobre qué propiedades usar, en su caso, cuando se llama a métodos externos. 

Como NET Framework cuenta con tal cantidad de clases de atributos, es 
imposible describir cada una de ellas en un solo capítulo. Ademas, como las 
clases de atributo son específicas de las clases en las que se definen, sólo son 
útiles en el contexto de esas clases. A medida que codifique aplicaciones y se vaya 
familiarizando con los espacios de nombres de NET Framework para los que esta 
codificando, las clases de atributo asociadas a los espacios de nombre se harán 
más transparentes. Algunas clases de atributo reservadas pueden funcionar por si 
mismas y afectar directamente al lenguaje CU. Las clases System. Obsolete- 
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A t tribute. System.SerializableAttribute y System. 
ConditionaiAttribute son clases de atributo que pueden usarse indepen¬ 
dientemente y que afectan directamente al resultado del código. 


NOTA: En .NET Framework, las clases de atributo tienen alias, por lo 
que, cuando se usan clases de atributo, es normal ver el nombre de la clase 
de atributo sin la palabra "Attribute" a continuación. El sufijo está implíci¬ 
to, de modo que la forma corta no produce un error. Por ejemplo, 
ObsoleteAttribute puede usarse como Obsolete, ya que los atri¬ 
butos están entre llaves, lo que hace evidente que son atributos y no algún 
otro tipo de modificador. 


Observemos algunas de las muchas clases de atributo disponibles en NET 
Framework. De esta forma, se acostumbrará al modo de trabajar de estas clases y 
al modo de aplicar estos atributos en el codigo de (’#. 

System.Diagnostics.ConditionalAttribute 

El atributo Cond i t i. o na 1. es el alias de System. Diagnostics . 

Condi t i ond 1 Attribute. que sólo puede aplicarse a declaraciones de meto- 
do de clase. Especifica que el método solo debe ser incluido como una parte de la 
elase si el compilador de C# define el símbolo que aparece como parametro del 
atributo. El listado 17.1 muestra el funcionamiento del atributo Cond i tional*. 

Listado 17.1. Cómo trabajar con ei atributo Conditional 


us mq 

3 ys t. em; 


us mq 

Syst em. 

P í agnos t: res 

publ i c 

c 1 a s s 

TestClass 

{ 

pu bl 

i c void Method i ( .) 


{ 

Conso 1e.Wr 1 1eLmef"Helio f rom Methodl !") ; 
I 

f Cund at lona 1 f"0E E U G") ] 
p u b'i.i c v o i d M e t. h o d 2 ( ) 

{ 

Conso1e.WriteLine ("Helio f rom Method2 ! w | ; 
I 


public void MethodEfJ 
í 

Console.Wri teLine ("Helio from Method3! "); 
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class MainClass 


{ 

public static void Main() 

{ 

TestClass MyTestClass - new TestClass ( ) ; 

MyTestClass .Methodl ( ) ; 

MyTestClass.Method2(); 

MyTestClass.Method3(); 

} 

} 


NOTA: Recuerde hacer referencia al espacio de nombre System. 
Diagnostics en el código de modo que no tenga que usar el espacio de 
nombre completo al usar la clase de atributo Conditional y el compilador 
de C# pueda encontrar la implementación de la clase. 


El listado 17.1 declara dos clases: TestClass y MainClass. La clase 
TestClass contiene tres métodos: Methodl { ). Method2 ( ) y Method3 ( ) . 

Las clases Methodl {) v Method3() se implementan sin atributos, pero 
Method2 () usa el atributo Conditional con un parámetro llamado DEBUG. 
Esto significa que el método Method2 ( ) es una parte de la clase sólo cuando el 
compilador de C# construye la clase con el símbolo DEBUG definido. Si el 
compilador de C# construye la clase sin haber definido el símbolo DEBUG. el 
método no se incluye como una parte de la clase y se pasa por alto cualquier 
llamada al método. La clase MainClass implementa el método Main ( ) de la 
aplicación, que crea un objeto de tipo TestClass y llama a los tres métodos de 
la clase. El resultado del listado 17.1 cambia dependiendo del modo en que es 
compilado el código. En primer lugar, intente compilar el listado 17.1 con el 
símbolo DEBUG definido. Puede usar el argumento de línea de comando del 
compilador de C# /D para definir símbolos para el compilador: 

esc /D:DEBUG Listingl7-l.cs 

Cuando el código del listado 17.1 se compila mientras el símbolo DEBUG esta 
definido, el método Method2 ( ) de la clase TestClass se incluye en la cons¬ 
trucción y al ejecutar la aplicación se escribe lo siguiente en la consola: 

Helio from Methodl! 

Helio from Method2! 

Helio from Method3! 

Ahora intente compilar el listado 17.1 sin el símbolo DEBUG definido: 

esc Listingl7-l.cs 
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Cuando se compila el código del listado 17 1 mientras el símbolo DEBUG no 
esta definido, el método Method2 ( ) de la clase TestClass no se incluye en 
la construcción y se pasa por alto la llamada al método Method2 ( ) realizada en 
el método Main ( ) . Si se crea el código del listado 17.1 sin definir el símbolo 
DEBUG se genera código que escribe lo siguiente en la consola al ser ejecutado: 

Helio from Methodl ! 

Helio from Method3! 

Como puede ver. el atributo Conditional es eficaz y útil. Antes de empe¬ 
zar a usar esta clase, preste atención a las siguientes reglas: 

• El método marcado con el atributo Conditional debe ser un método de 
una clase. 

• El método marcado con el atributo Conditional no debe ser un método 

override. 

• El método marcado con el atributo Conditional debe tener un tipo 
devuelto void. 

• Aunque el método marcado con el atributo Conditional no debe estar 
marcado con el modificador override. puede estar marcado con el mo¬ 
dificador virtual. Los reemplazos de estos métodos son implícitamente 
condicionales y no deben estar marcados explícitamente con un atributo 

Conditional. 

• El método marcado con el atributo Conditional no debe ser una 
implementación de un método de interfaz; en caso contrario, se producirá 
un error en tiempo de compilación. 

System.SerializableAttribute class 

El atributo Serializable es el alias de la clase System.Seriali- 
zableAttribute. que puede ser aplicado a clases. Indica a NET Framework 
que los miembros de la clase pueden ser señalizados a y desde un medio de 
almacenamiento, como un disco duro. El uso de este atributo hace que no resulte 
necesario agregar la función de estado en las clases para que su almacenamiento 
en el disco y su posterior recuperación. Cuando se señalizan tipos, todos los 
datos de la clase marcada como Serializable se guardan en el estado en el 
que se encuentran cuando el dato es persistente. Si hay tipos dentro de la clase que 
no quiere que sean persistentes, puede marcarlos con el atributo NonSerialized. 
que es el alias de la clase System. NonSerializableAttribute. En el 
siguiente fragmento de código, los datos de la cadena password marcados como 
NonSerialized no son persistentes para el archivo o flujo para el que se 
escriben los datos de clase: 
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[Serializable ( ) ] 
public class Users{ 


public string username; 
public string emaiiaddress; 
public string phonenumber; 

// Añada un campo que no vaya a ser persistente 

[NonSerialized()] public string password; 

public FillData() { 

username = "admin"; 
password = "password"; 

emailaddress = n billg@microsoft.com" ; 
phonenumber = "555-1212"; 

} 

} 

Para mostrar un ejemplo de señalización completo, el listado 1 7.2 vuelve a la 
clase Point2D con la que ya hemos trabajado. La clase está marcada con el 
atributo Serializable. lo que significa que puede ser guardada y leída desde 
un flujo de datos. 

Listado 17.2. Cómo trabajar con el atributo Serializable 

using System; 
using System.10; 

using System.Runtime.Serialization.Formatters.Binary; 

[Serializable] 
class Point2D 
{ 

public int X; 
public int Y; 

} 


class MyMainClass 

{ 

public static void Main() 

{ 

Point2D My2DPoint = new Point2D(); 

My2 DPoint.X = 100; 

My2 DPoint.Y = 200; 

Stream WriteStream = File.Create("Point2D.bin"); 
BinaryFormatter BinaryWrite = new BinaryFormatter(); 
BinaryWrite.Serialize(WriteStream, My2DPoint); 
WriteStream.Cióse(); 

Point2D ANewPoint = new Point2D(); 
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Consolé .WriteLine("New Point Before Deserialization: {{0}, 

{ 1} ) " , ANewPoint.X, ANewPoint.Y) ; 

Stream ReadStream = File.OpenReadrPoint2D.bin") ; 

BinaryFormatter BinaryRead 'm new BinaryFormatter(); 

ANewPoint = (Point2D) BmaryRead.Deserialize (ReadStream) ; 

ReadStream.Cióse(); 

Consolé.WriteLine("New Point After Deserialization: ({0}, 

{1})", ANewPoint.X, ANewPoint.Y); 

} 

} 

El código del listado 17.2 crea un nuevo objeto Point2D y le otorga las 
coordenadas ( 100 , 200 ). A continuación señaliza la clase en un archivo 

llamado Point2D.bin. 

El código crea entonces un nuevo punto y deserializa los contenidos del archi¬ 
vo Point2D.bin en el nuevo objeto Point2D. El proceso de deserialización 
lee el archivo Point2D.bin y asigna los valores que se encontraban en el 
archivo binario a los valores del objeto. Si se ejecuta el código del listado 1 7.2 se 
escribe lo siguiente en la consola: 

New Point Before Deserlalization: (0, 0) 

New Point After Deserialization: (100, 200) 

Cuando se crea el nuevo objeto Point2D. sus miembros se inicializan con 
sus valores por defecto de 0. El proceso de deserialización. que asigna los valores 
de acuerdo con los datos almacenados en el archivo Point2D.bin. cambia los 
valores. El listado 17.2 emplea dos clases de NET Framcvvork en su proceso de 
señalización La clase Stream se encuentra en el espacio de nombre System. 10 
v gestiona el acceso a los flujos de datos, incluyendo los archivos de disco. La 
clase BinaryFormatter se encuentra en el espacio de nombre 
System . Runtime . Serialization . Formatters . Binary y gestiona 
la serialización de datos a una representación binaria. NET Framework incluye 
otros formateadores que pueden usarse para representar datos serial izados en 
otros formatos. Por ejemplo, la clase SoapFormatter da a los datos señalizados 
un formato adecuado para una llamada XML SOAP. 


NOTA: La clase BinaryFormatter es una patente de .NET Framework. 
Si tiene pensado que nt destino sean otros sistemas que pueden no ser 
compatibles con ei formato binario, considere usar ia clase Soap- 
Formatter para que persistan los datos de un formato XML que es com¬ 
patible con otros sistemas. 


System.ObsoleteAttribute class 

El atributo Obsolete puede ser aplicado a cualquier tipo de C# excepto a 
ensamblados, módulos, parámetros y valores devueltos. El atributo Obsolete 
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permite definir fragmentos de código que se van a reemplazar o que ya no son 
válidos. Las propiedades Message e IsError de la clase Obsolete otorgan 
el control del modo en el que el compilador controla los tipos marcados con el 
atributo Obsolete. Al asignar a la propiedad IsError el valor True. el 
compilador produce un error y el mensaje de error es la propiedad de cadena 
asignada a la propiedad Message. El valor por defecto de la propiedad IsError 
es False. lo que hace que se produzca un aviso cuando se compila el código. En 
el siguiente código, el método HelloWorld está marcado como Obsolete. 

usmg System; 
public class RunThis 
{ 

public static void Main() 

{ 

// Esto genera un aviso de tiempo de compilación. 

Consolé.WriteLine(HelloWorld()); 

Consolé.ReadLine () ; 

} 


// Marca HelloWord como Obsolete 

[Obsolete ("Next versión uses Helio Umverse") ] 
public static stnng HelloWorld{) 

{ 

return ("HelloWorld”); 

} 

} 


La figura 17.1 muestra la lista de tareas de los avisos producidos al compilar 
el código anterior. 


lista de tareas - 1 tarea(s): Error al generar (filtro) 


y Descripción 


|^| ¡'RunThis,HelloWorldQ 1 esta obsoleto: 'Next versión uses Helio Universe' 


jil Lista de tareas | El _I 

Figura 17.1. Aviso producido al emplear el atributo obsolete 

Si quiere asegurarse de que se produce un error y no sólo un mensaje de aviso, 
puede modificar el código marcado asignando a la propiedad IsError el valor 
true y la clase no se compilará. Si modifica el atributo Obsolete del código 
anterior con la siguiente linea, se produce un error: 

[Obsolete("Next versión uses Helio Universe", true)] 

Como puede ver. el uso del atributo Obsolete permite mantener el codigo 
existente mientras nos aseguramos de que los programadores no están usando 
tipos desfasados. 
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Cómo escribir sus propias clases de atributo 


NET Framework parte con un buen número de clases de atributo que pueden 
usarse para diferentes propósitos. Sin embargo, podría necesitar un atributo que 
cumpliera una función no incluida en .NET Framework. Por ejemplo, podría 
desear disponer de un atributo de revisión de código que etiquetara una clase con 
la fecha de la última vez que el código de esa clase fue revisado por sus compañe¬ 
ros. En ese caso, necesitará definir sus propios atributos y hacer que funcionen 
como cualquier atributo incluido en NET Framework. Por suerte. .NET Framework 
admite perfectamente la construcción de nuevas clases de atributos. En esta sec¬ 
ción aprenderemos cómo el código NET desarrolla y usa las nuevas clases de 
atributos. 

Puede escribir sus propias clases de atributos y usarlas en su código del mismo 
modo que usaría un atributo procedente de NET Framework. Las clases de atri¬ 
buto personales funcionan como clases normales; tienen propiedades y métodos 
que permiten al usuario del atributo asignar y recuperar datos. 

Los atributos se implementan con clases de atributo. Las clases de atributo 
derivan de una clase del espacio de nombre System de NET llamada 
Attribute. Por norma, las clases de atributo llevan antepuesta la palabra 
Att ribute: 

public class CodeAuthorAttribute : Attribute 
{ 

} 


Esta clase define un atributo llamado CodeAuthorAttribute. Este nom¬ 
bre de atributo puede usarse como un atributo una vez que se ha definido la clase. 
Si el nombre de atributo termina con el sufijo Attribute, el nombre de atribu¬ 
to puede ser usado entre corchetes o sin el sufijo: 

[CodeAuthorAttribute ] 

[CodeAuthor] 

Estos dos atributos hacen referencia a la clase CodeAuthorAttribute. 
Tras definir una clase de atributo, se usa como cualquier otra clase de atributo 
NET 

Cómo restringir el uso de atributos 

Las clases de atributo pueden, a su vez, usar atributos. El ejemplo más común 
es un atributo llamado AttributeUsage. El atributo AttributeUsage 
contiene un parámetro que especifica dónde puede usarse un atributo. Algunos 
atributos pueden no tener sentido en todos los constructores de C# válidos. Por 
ejemplo, el atributo Obsolete tratado con anterioridad sólo tiene sentido en 
métodos. No es lógico marcar una sola variable como obsoleta, de modo que el 
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atributo Obsolete solamente debe aplicarse a métodos y no a otros constructo¬ 
res de C#. La clase de atributo AttributeUsage contiene una enumeración 
publica llamada AttributeTargets. cuyos miembros aparecen en la tabla 
17.1. 

Estos miembros AttributeTargets pueden aparecer juntos en una ex¬ 
presión OR y ser usados como parámetros del atributo AtrributeUsage para 
especificar que la clase de atributo define un atributo que sólo puede usarse en 
determinados contextos, como muestra el siguiente ejemplo: 

[AttributeUsage(AttributeTargets.Class | 

AttributeTargets.Struct)] 

public class CodeAuthorAttribute : Attribute 
{ 

} 


Este constructor declara una clase llamada CodeAuthorAt tribute y es¬ 
pecifica que el atributo sólo puede ser usado con clases y estructuras. 

El compilador de C# le fuerza a usar el atributo para asegurarse de que se 
emplea de acuerdo con los valores de la enumeración deAttributeTargets 
especificados en el atributo Attr ibuteUsage. Si usa un atributo en una ex¬ 
presión que no está permitida en la definición del atributo, el compilador emitirá 
un error. 

Por ejemplo, suponga que escribe un atributo llamado Ñame y sólo usa la 
enumeración At tributeTarget s . Class como parámetro del atributo 

AttributeUsage: 

[AttributeUsage(AttributeTargets.Class)] 
public class NameAttribute : Attribute 
{ 

} 

Si a continuación intenta aplicar el atributo Ñame a algo que no sea una clase, 
el compilador emitirá un mensaje de error parecido al siguiente: 

error CS0592: El atributo "Ñame" no es valido en este tipo de 
declaración. Sólo es válido en declaraciones "class". 

Cómo permitir múltiples valores de atributo 

También se puede usar el atributo AttributeUsage para especificar si 
una clase permite que varias instancias de un atributo sean usadas en un fragmen¬ 
to de código C# en particular. Esto se especifica mediante un parámetro de atribu¬ 
to llamado AllowMultiple. Si el valor de AllowMultiple es True. se 
pueden usar varias instancias del atributo en un elemento particular de C#. Si 
AllowMult iple recibe el valor False, sólo se puede usar una instancia en 
cualquier elemento particular de C# (aunque sigue estando permitido aplicar el 
atributo a más de un constructor de C#): 
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[AttributeUsage(AttributeTargets.class , AllowMultiple - true) ] 
public class NameAttribute : Attribute 
{ 

public NameAtt nbute ( str ing Ñame) 

{ 



El uso de varios atributos permite asignar varios valores a un constructor de 
C# usando un solo atributo. El siguiente constructor marca el atributo Ñame 
como un atributo de varios usos y permite a los programadores usar el atributo 
más de una vez en un solo elemento de C#: 

[Ñame("Jetf Ferguson")] 

[Ñame( " Je f t Ferguson's Assistant") ] 
public class MyClass 
{ 

} 


Los atributos de varios usos también pueden aparecer en un solo conjunto de 
corchetes, separados por una coma: 

[Ñame("Je £ f Ferguson"), Name("Jeff Ferguson's Assistant")] 
public class MyClass 
{ 

} 


Si no especifica un valor para el parámetro AllowMult iple. no se permite 
el uso variado. 

Cómo asignar parámetros de atributo 

Sus clases de atributo pueden aceptar parámetros, que aparecen entre parénte¬ 
sis después del nombre de atributo. En el ejemplo anterior, el atributo Ñame 
recibe una cadena que da nombre al creador de código como parámetro. Algunos 
atributos necesitan parámetros para asociar los datos al atributo, como la cadena 
de nombre en el atributo Ñame mostrado anteriormente. 

Los valores de los parámetros se pasan al constructor de la clase de atributo y 
la clase de atributo debe implementar un constructor que pueda recibir los 
parámetros: 

[AttnbuteUsage (Attr i bu teTargets . Class | 

AttnbuteTargets .Struct) ] 

public class CodeAuthorAttribute : Attribute 

{ 

public CodeAuthorAttribute{string Ñame) 

{ 
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Este atributo necesita que se suministre un parámetro de cadena cada vez que 
es usado: 

[CodeAuthor("Jeff Ferguson") ] 

Debe suministrar los parámetros especificados en el constructor de la clase 
cuando se usa el atributo. En caso contrario, obtendrá un error del compilador: 

error CS1501: Ninguna sobrecarga para el método 

'CodeAuthorAttríbute' adquiere '0' argumentos 

Los parámetros proporcionados al constructor de la clase de atributo reciben 
el nombre de parámetros posicionales . Los parámetros posicionales asocian los 
datos de parámetro con sus nombres de parámetro basándose en la posición de los 
datos en la lista de parámetros. Por ejemplo, el elemento de datos del segundo 
parámetro está asociado a la v ariable del segundo parámetro especificada en la 
lista de parámetros de la declaración de la función También se pueden proporcio¬ 
nar parámetros con nombre, que son almacenados por las propiedades 
implementadas en la clase de atributo. Los parámetros con nombre se especifican 
con el nombre de la propiedad, un signo igual y el valor de la propiedad Los 
parámetros con nombre se asocian a datos de parámetros con el nombre del 
parámetro basado en el nombre del parámetro que aparece antes del valor. Dado 
que la asociación entre un nombre de variable y su valor se especifica mediante el 
nombre del parámetro y no mediante la posición del valor en la lista de parámetros, 
los parámetros con nombre pueden aparecer en cualquier orden. 

Suponga que añade un parámetro con nombre llamado Date al atributo 
CodeAuthorAttribute. Esto significa que la clase puede admitir una pro¬ 
piedad llamada Date cuyo valor puede asignarse en la definición del atributo: 

[AttributeUsage(AttributeTargets.Class | 

At tribu teTargets.Struct) ] 

public class CodeAuthorAttribute : Attribute 

{ 

public CodeAuthorAttribute(string Ñame) 

{ 

} 

public string Date 

í 

set 

{ 

} 



Tras definir la propiedad, un parametro con nombre puede establecer su pro¬ 
piedad cuando el atributo aparezca en el código: 

[CodeAuthor("Jeff Ferguson", Date = "Apr 01 2001")] 
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A diferencia de los parámetros posicionales, los parámetros con nombre son 
opcionales y pueden omitirse de una especificación de atributo. 

Ejemplo explicativo de las clases de atributo 

En este apartado creará un nuevo atributo llamado ClassAuthor y lo usará 
en código C#. Esto le dará una idea sobre cómo el código .NET define y usa 
nuevos atributos. El listado 17.3 agrega una nueva clase al código del listado 
17.2. Esta nueva clase recibe el nombre de ClassAuthorAttribute y deri¬ 
va de la clase .NET Attribute. 

Listado 17.3. Cómo definir nuevas clases de atributo 

using System; 

usmg System. Diagnostics ; 

using System.Reflection; 

[ AttributeUsage(AttributeTargets.Class) ] 
public class ClassAuthorAttribute : Attribute 
{ 

private stnng AuthorName; 

public ClassAuthorAttribute(string AuthorName) 

{ 

this.AuthorName = AuthorName; 

} 


public string Author 


ge t 

{ 

return AuthorName; 


) 

[ClassAuthor ("Jeff Ferguson") ] 
public class TestClass 
{ 

public void Method'l ( ) 

{ 

Consolé.WriteLine("Helio from Methodl!”); 

} 


[Conditional ("DEBUG") ] 
public void Method2{) 

{ 

Consolé.WriteLine("Helio from Method2!"); 

} 


public void Method3() 
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Consolé.WriteLine("Helio from Method3!"); 


} 


public class MainClass 
{ 

public static void Main() 

{ 

TestClass MyTestClass = new TestClass(); 

MyTestClass.Methodl ( ) ; 

MyTestClass.Method2 () ; 

MyTestClass.Method3 () ; 

object [] ClassAttributes; 

Memberlnfo Typelnformation; 

Typelnf ormation = t ypeof (TestClass):.; 

ClassAttributes = 

Typelnformation.GetCustomAttributes(typeof(ClassAuthorAttribute), 
f a 1 s e ) ; 

íf (ClassAttributes.GetLength ( 0) ! = 0) 

I 

ClassAuthorAttribute ClassAttribute; 

ClassAttribute = 

(ClassAuthorAttribute) <ClassAttributes [ UJ ) ; 

Consolé.WriteLine ( "Class Author: {0}", 

C1 as sAttribute.Author) ; 

} 

} 

} 


El codigo de 1 listado 17.3 comienza con una nueva clase de atributo llamada 
CodeAuthorAttribute. La clase sirve como una clase de atributo para un 
atributo que sólo puede aplicarse a otras clases. La clase recibe un parámetro de 
cadena, que se almacena en una variable priv ada v al que se accede públicamente 
mediante una propiedad de sólo lectura llamada Author. La intención del 
parámetro es marcar una clase como poseedora de un nombre de programador 
específico adjunto, de modo que los demás programadores sepan con quién deben 
contactar si tienen alguna duda sobre la implementación de la clase. 

La clase TestClass usa el atributo CodeAuthor v proporciona el parametro 
Jeff Ferguson. 

bl rasgo más interesante del listado 17.3 es el método Main ( ) . que obtiene un 
objeto de atributo de la clase v escribe el nombre del autor. Esto lo hace mediante 
un concepto llamado reflexión . que implementa las clases de un espacio de nom¬ 
bres NET llamado System. Ref lect ion. Mediante la reflexión, el codigo 
puede, en tiempo de ejecución, estudiar la implementación de una clase y descu- 
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brir cómo está construida. La reflexión permite que el código examine otros frag¬ 
mentos de código para derivar información, como los métodos y propiedades que 
admite y la clase base de la que deriva. La reflexión es una función muy potente y 
es completamente compatible con .NET Framework. 

El código del listado 17.3 usa la reflexión para obtener una lista de atributos 
asociados a una clase particular. El código de atributo comienza recuperando un 
objeto Type para la clase TestClass. Para conseguir el objeto Type se usa el 
operador de CU typeof ( ) . Este operador toma como argumento el nombre de 
la clase cuyo tipo de información se va a recuperar. El objeto Type devuelto, que 
está definido en el espacio de nombre de NET Framework System, funciona 
como una tabla de contenidos, describiendo todo lo que se debe saber sobre la 
clase requerida. 

Después de recuperar el objeto Type para la clase, el método Main ( ) llama 
a un método llamado GetCustomAttributes ( ) para conseguir una lista de 
los atributos que permite la clase descrita por el objeto Type. Este método de¬ 
vuelve una matriz de objetos y acepta como parámetro el tipo del atributo que 
debe recuperarse. En el listado 17.3, el método GetCustomAt tributes ( ) 
es invocado con información de tipo para la clase CodeAuthorAttribute 
como parámetro. Esto obliga al método GetCustomAt tributes ( ) a devol¬ 
ver sólo información sobre los atributos de clase que sean del tipo 
CodeAuthorAttribute. Si la clase hubiera usado algún otro atributo, la 
llamada no podría devolverlos. El código del listado 17.3 finaliza tomando el 
primer atributo CodeAuthorAttribute de la matriz y solicitándole el valor 
de su propiedad Author. El valor de la cadena se escribe en la consola. 

Si se ejecuta el código del listado 17.3 se escribe lo siguiente en la consola (si 
compila el código sin definir el símbolo DEBUG): 

Helio from Methodl! 

Helio from Method3! 

Cíass Author: Jeff Ferguson 


Resumen 


NET Framework permite usar atributos en los lenguajes que se ejecutan con 
el CLR. El concepto de atributo abre la puerta a la expansión de la funcionalidad 
de los lenguajes NET con clases que pueden agregar comportamientos al código. 
El lenguaje CU permite el uso de atributos creados por otras personas en su 
código CU y también la creación de atributos propios, que pueden ser usados por 
otros programadores de NET. 

El concepto de atributo no es exclusivo de CU: más bien, está disponible para 
cualquier lenguaje que se ejecute con el CLR. Los atributos le conceden la posibi¬ 
lidad de extender el entorno del lenguaje y aporta nuevas herramientas para que 
los programadores trabajen con código NET, El proceso de serialización es un 
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buen ejemplo de esto. La señalización no está integrada en la especificación del 
lenguaje C#. pero su funcionalidad está disponible por medio de una clase de 
atributo escrita por Microsoft. La clase de atributo extiende el lenguaje en tiempo 
de ejecución para que admita una característica que no fue diseñada en ese len¬ 
guaje. 

Al igual que los demás constructores de NET Framework. los atributos son 
objetos. Se definen por clases que derivan de la clase System. At tribu te de 
NET Framework. Puede usar C# para desarrollar nuevas clases de atributo con 
sólo derivar una nueva clase de la clase base System. At tribute. Los atri¬ 
butos que desarrolle en C# y los atributos ya definidos por NET Framework 
pueden ser usados por cualquier lenguaje compatible con el CLR. 

Los atributos se usan especificando entre corchetes el nombre de clase del 
atributo, inmediatamente antes del constructor de C# al que se aplica el atributo. 
Los atributos pueden aceptar datos en forma de parámetros, que pueden asociar 
datos de estado al atributo. Estos datos pueden ser recuperados por código de 
reflexión que puede consultar el código y buscar atributos 
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11:1 Cómo 

utilizar 
versiones 
en sus clases 


Casi todo el código escrito para las modernas aplicaciones evoluciona con el 
tiempo. Los proyectos de software comienzan con un conjunto de requisitos y se 
diseñan las clases para que cumplan esos requisitos. Este primer codigo base 
sirve como código fuente de la versión 1.0 de la aplicación. Sin embargo, casi 
todas las aplicaciones van más allá de la versión 1.0. Las actualizaciones de la 
aplicación proceden de un grupo de requisitos mejorado y la versión 1.0 del codi¬ 
go base debe ser revisada para implementar los requisitos actualizados. 

El lenguaje C# admite constructores que hacen las clases lo suficientemente 
estables como para evolucionar mientras cambian los requisitos de la aplicación. 
En este capítulo, aprenderemos a usar las palabras clave new y override en 
métodos de clase de C# para asegurarnos de que las clases pueden continuar 
usándose a medida que cambian los requisitos de la aplicación 

El problema de las versiones 

Antes de aprender a usar las palabras clave new y override para hacer las 
clases de su código de C# compatibles con el código base que tiene que mantener¬ 
se al día con los requisitos de cambio, observe como sería la vida sin estas pala- 



bras clave. Si recuerda el capítulo 8. las clases que creamos y usamos pueden 
ser consideradas clases base. Estas clases tienen la funcionalidad básica que necesi¬ 
tan las aplicaciones. Al declarar una instancia de una clase, está derivando de esa 
clase para usar su funcionalidad. 

Las bibliotecas de clases base de .NET Framework están basadas en este mo¬ 
delo; todo lo que hacemos mientras programamos aplicaciones .NET está basado 
en una clase base. Todo el entorno deriva de la clase base System . Ob j ect. de 
modo que incluso cuando deriva una simple variable está derivando una 
funcionalidad de la clase base System.Object. 

El listado 18.1 muestra las características de las clases base y derivadas. 

Listado 18.1. Una clase base y una clase derivada 

using System; 

public class BaseClass 

{ 

protected int Valué; 

public BaseClass() 

{ 

Valué = 123; 


} 

public class DerivedClass : BaseClass 
{ 

public void PnntValue () 

{ 

Consolé .WriteLine ■( "Valué = " + Valué) ; 



class MainClass 
{ 

public static void Main() 

{ 

DerivedClass DerivedClassObject = new DerivedClass(); 
DerivedClassObject.PrintValue () ; 



El codigo del listado 18.1 es relativamente sencillo. Contiene una clase base 
llamada BaseClass que incluye una variable entera protegida. Otra clase, lla¬ 
mada Der i vedC l ass. deriva de la clase BaseClass e implementa un méto¬ 
do llamado PrintValue ( ) . El método Main ( ) crea un objeto de tipo 
DerivedClass y llama a su método PrintValue ( ) . Si se ejecuta el código 
del listado 1 8.1 se escribe lo siguiente en la consola: 

Valué = 123 
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Ahora suponga que los requisitos cambian y otro programador decide desarro¬ 
llar la clase BaseClass mientras continuamos trabajando en nuevas mejoras 
para la clase DerivedClass. ¿Que ocurrirá si el otro programador agrega un 
método a la clase BaseClass llamado PrintValue ( ) y proporciona un 
implementación ligeramente diferente? El código seria como el listado 1X 

Listado 18.2. Adición de PrintValueO a la clase BaseClass 

using System; 

public class BaseClass 

{ 

protected int Valué; 

public BaseClass () 

{ 

Valué - 12 3; 

} 

public virtual void PrintValueO 

{ 

Consol e.WriteLine("Valué: " + Valué); 

} 

} 


public class DerivedClass : BaseClass 
( 

public void PrintValue () 

{ 

Consolé.WriteLine("Valué = " + V 

} 

} 


class MamClass 
{ 

public static void Main() 

DerivedClass DenvedClassObject = new DerivedClass ( } , 
Denvédelas sOb] ect.PrintValue { } ; 


Ahora tenemos un problema. La clase DerivedClass deriva de la clase 
BaseClass y ambas implementan un método llamado PrintValue ( ) La 
clase BaseClass ha sido actualizada a una nueva versión, mientras que la clase 
DerivedClass ha permanecido con su implementación original En el listado 
18.2. la relación entre el método PrintValue ( ) de la clase base y el método 
PrintValue ( ) de la clase derivada no esta clara. El compilador debe saber 
qué método reemplaza a la versión de la clase base. Y el compilador no sabe que 
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implementación debe ejecutar cuando el método Main( ) llama al método 

PrintValue ( ). 

Como resultado, el compilador de C# remarca esta ambigüedad con un aviso: 

warning CS0114: 'DenvedClass. PrintValue () ' oculta el miembro 
heredado 'BaseClass.PrintValue ()' . Para hacer que el método 
actual reemplace esa implementación, agregue la palabra clave 
override. De lo contrario, agregue la palabra clave new. 

Éste es un buen aviso, porque la filosofía del lenguaje C# fomenta la claridad 
y el compilador de C# siempre avisa sobre los constructores de código que no 
están claros. 

Cómo solucionar el problema 
de las versiones 

C# tiene dos modos de solucionar la ambigüedad del listado 18.2: 

• Usar el modificador new para especificar los dos métodos que. en reali¬ 
dad. son diferentes. 

• Usar el modificador override para especificar que el método de la clase 
derivada debe reemplazar al método de la clase base. 

Examinemos estos dos métodos. 

Mediante el modificador new 

Si las dos implementaciones de método del listado 18.2 deben ser tratadas 
como métodos separados que simplemente tienen el mismo nombre, el método de 
la clase derivada debe llevar antepuesto el modificador new. Al usar el modifica¬ 
dor new. puede ocultar explícitamente los miembros heredados de la 
implementación de la clase base. Simplemente debe declarar un miembro en su 
clase derivada con el mismo nombre y anteponer a la declaración el modificador 
new y se usará la funcionalidad de la clase derivada, como muestra el listado 
18.3. 

Listado 18.3. Cómo resolver la ambigüedad mediante la palabra reservada new 

using System; 

public class BaseClass 
{ 

protected int Valué; 
public BaseC 1.ass () 
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{ 

Valué = 123; 

} 

public void PrintValue() 

{ 

Consolé.WriteLine("Valué: " + Valué); 

} 

} 

public class DerivedClass : BaseClass 
{ 

new public void PrintValue{) 

{ 

Consolé.WriteLine("Valué = " + Valué); 



class MainClass 
{ 

public static void Main() 

{ 

DerivedClass DerivedClassObject - new DerivedClass í) ; 
DerivedClassObject.PrintValúe ( ) ; 



NOTA: El operador new y el modificador new son implementaciones di¬ 
ferentes de la palabra clave new. El operador new se usa para crear ob¬ 
jetos, mientras que el modificador new se usa para ocultar un miembro 
heredado de un miembro de clase base. 


El codigo del listado 18.3 usa la palabra clave new en la implementación del 
método PrintValue ( ) de la clase DerivedClass. Esto índica al compilador 
de C# que debe tratar este método como distinto del método de la clase base, 
aunque los dos métodos tengan el mismo nombre. El uso de la palabra clave 
resuelve la ambigüedad y permite que el compilador de CU compile el codigo sin 
emitir advertencias. En este caso, el método Main ( ) llama al método de la clase 
derivada y el listado 18.3 escribe lo siguiente en la consola: 


Valué = 123 


Todavía puede ejecutar el método de la clase base porque la palabra clave new 
ha asegurado básicamente que los dos métodos PrintValue ( ) de cada una de 
las clases puede ser llamado por separado. Puede llamar al método de la clase 
base convirtiendo explícitamente el objeto de la clase deriv ada en un objeto de 
tipo de la clase base: 
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BaseClass BaseC1assObject 


(BaseClass)DerivedClassObject; 


BaseClassObj ect.PrintValue () I 

Como puede ver. el uso del modificador new solamente permite reemplazar la 
funcionalidad en una clase base. 

Si necesita usar la funcionalidad de la clase original, use el nombre de la clase 
completo y su ruta de acceso con el miembro de la clase para estar seguro de que 
está usando la funcionalidad correcta. 

Mediante el modificador override 

La otra opción para resolver la ambigüedad con los nombres de método dupli¬ 
cados es usar el modificador override para especificar que la implementación 
de la clase derivada reemplaza a la implementación de la clase derivada. El modi¬ 
ficador override "reemplaza" la funcionalidad del miembro de la clase base al 
que sustituye. 

Para reemplazar a un miembro de una clase, la firma del miembro que reem¬ 
plaza debe ser la misma que el miembro de la clase base. Por ejemplo, si el 
miembro que realiza el reemplazo tiene un constructor, los tipos en el constructor 
deben coincidir con los del miembro de la clase base. En el listado 18.4 puede ver 
el funcionamiento del modificador override. 

Listado 18.4. Cómo resolver la ambigüedad mediante el modificador override 

using System; 

public class BaseClass 

í 

protected int Valué; 

public BaseClass() 

{ 

Valué - 123; 

} 


public virtual void PrintValue() 

{ 

Consolé.WriteLine("Valué : " + Valué); 

} 


public class DerivedClass : BaseClass 
{ 

override public void PrintValue() 

{ 

Consolé.WriteLine("Valué = " + Valué); 

} 
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} 

class MainClass 
{ 

public static void Main() 

{ 

DerivedClass DerivedClassObj ect = new DenvedClass ( ) ; 
Derivede1assObj ect.PrintValue() ; 


En el listado 18.4. la palabra clave override indica al compilador de C# 
que la iniplementación de PrintValue ( ) en la clase derivada reemplaza a la 
implementación del mismo método en la clase base. La implementación de la clase 
base está oculta básicamente a los invocadores. A diferencia del listado 18.-V el 
código del listado 18.4 sólo contiene una implementación de PrintValue ( ) . 

La implementación de la clase base de PrintValue ( ) no es accesible al 
código del método Main ( ). incluso si el código convierte explícitamente el obje¬ 
to de la clase derivada en un objeto de clase base y llama al método en el objeto de 
la clase base. 

Debido a que la palabra clave override se usa en el listado 18.4. todas las 
llamadas al método realizadas mediante un objeto convertido explícitamente son 
dirigidas a la implementación reemplazada de la clase derivada. 

Observe el código usado en la llamada a la implementación de la clase base de 
PrintValue ( ) cuando se usa el operador new para resolver la ambigüedad: 

BaseClass BaseC1assObject = (BaseClass)DerivedClassObject; 

BaseClassOb]ect.PrintValue () ; 

Este código no es suficiente para hacer que se llame a la implementación de la 
clase base cuando se use la palabra clave override. Esto es debido a que el 
objeto fue creado como un objeto de la clase DerivedClass. Puede llamar al 
método de la clase base pero, debido a que la implementación de la clase base ha 
sido reemplazada con el código de la clase derivada, se seguirá invocando a la 
implementación de la clase derivada. Debe usar la palabra clave de C# base 
para llamar a la implementación de la clase base, como en el siguiente ejemplo. 

base.PrintValue ( ) ; 

Esta instrucción llama a la implementación de PrintValue ( ) que se en¬ 
cuentra en la clase base de la clase actual. Al colocar esta instrucción en la clase 
DerivedClass. por ejemplo, se llama a la implementación de PrintValue ( ) 
que se encuentra en la clase BaseClass. Puede considerar el uso de la palabra 
clave base igual al uso de la sintaxis completa y con ruta de acceso 
namespace . ob j ect. metbod. ambas simplemente hacen referencia a la ins¬ 
tancia de clase base correcta que se está usando. 
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Resumen 


Los ejemplos de este capítulo situaban juntas todas las clases del listado en un 
único archivo fuente para hacerlos más sencillos. Sin embargo, la programación 
en el mundo real puede ser más complicada. Si varios programadores están traba¬ 
jando en un único proyecto, el proyecto podría estar formado por más de un 
archivo fuente. El programador que trabaja en la clase base podria colocarla en 
un archivo fuente de CU y el programador que trabaja en la clase derivada puede 
colocarla en otro archivo fuente de CU. El asunto podría ser aún mas complicado 
si la clase base se compila en un ensamblado y se implcmenta la clase deriv ada en 
un proy ecto que hace referencia al ensamblado. 

Lo importante en este caso es que las clases base y las clases deriv adas pueden 
proceder de varias fuentes diferentes y que coordinar la programación de las 
clases cobra una gran importancia. Es de vital importancia comprender que. con 
el tiempo, las clases base y las clases derivadas añadirán funcionalidades a medi¬ 
da que el provecto progrese. Como programador, debería tener esto en cuenta: 
diseñe sus clases de modo que pueden ser usadas en varias versiones de un 
prov ecto y puedan ev olucionar a medida que ev olucionen los requisitos del pro¬ 
yecto. 

A priori. la otra solución para los problemas que presentan las versiones es 
incluso mas sencillo: no use el mismo nombre para métodos que tengan 
¡mplementaciones diferentes a menos que esté reemplazando realmente la 
funcionalidad de la clase base. Aunque, en teoría, éste puede parecer el mejor 
medio para solventar el problema, en la práctica no siempre es posible. Las pala¬ 
bras clave de CU now y override le ayudan a cv itar este problema de progra¬ 
mación y le permiten reutilizar nombres de métodos en caso de que sea necesario 
para su provecto. El principal uso de la palabra clave override es av isar de la 
creación de nuevas ¡mplementaciones de métodos v irtuales en clases base, pero 
también tiene un papel en las versiones de CU. 
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IK1 Cómo 
trabajar 
con código 
no seguro 


Al usar la palabra clave new para crear una nueva instancia de un tipo de 
referencia, está pidiendo al CLR que reserve suficiente memoria para la variable. 
El CLR asigna suficiente espacio en la memoria para la variable y asocia la 
memoria a la variable. En condiciones normales, el codigo desconocería la locali¬ 
zación actual de esa memoria, por lo que respecta a la dirección de memoria 
Después de que la operación new tenga éxito, el codigo puede usar la memoria 
asignada sin saber ni importarle en que parte del sistema está realmente situada 
la memoria. 

En C v C++. los programadores tienen acceso directo a la memoria C' liando 
un fragmento de código de C o de C++ solicita acceso a un bloque de memoria, se 
le otorga la dirección específica de la dirección asignada y el código lee y escribe 
directamente en esa posición de memoria. La ventaja de este enfoque es que el 
acceso directo a la memoria es extremadamente rápido y contribuye a la eficien¬ 
cia del codigo. Sin embargo, hay algunos inconvenientes que superan a las venta¬ 
jas. El problema de este acceso directo a la memoria es que es fácil usarlo 
incorrectamente y esto hace que el código falle Un mal funcionamiento del códi¬ 
go de C o C++ puede fácilmente escribir en la memoria de otra variable. Estos 
problemas de acceso a memoria producen numerosos fallos y errores de software 
difíciles de localizar. La arquitectura del CLR elimina todos estos problemas rea¬ 
lizando toda la gestión de memoria por nosotros. Esto significa que su codigo de 



C# puede trabajar con variables sin que necesitemos conocer los detalles de 
cómo y donde se almacenan las variables en memoria. Como el CLR protege al 
código de C# de estos detalles de la memoria, el código de C# está libre de 
errores relacionados con el acceso directo a la memoria. 

No obstante, alguna vez tendrá que trabajar con una dirección de memoria 
especifica del código C#. El código puede necesitar un poco más de rendimiento o 
quizas el código de C# quiera trabajar con código heredado que necesite que le 
proporcione la dirección de un fragmento de memoria especifico. El lenguaje C# 
admite un modo especial, llamado modo no seguro . que permite trabajar directa¬ 
mente con memoria desde el interior del código C#. 

Este constructor de C# especial recibe el nombre de modo no seguro porque el 
código ya no dispone de la protección que ofrece la gestión de memoria del CLR. 
En el modo no seguro, el código de C# puede acceder directamente a la memoria 
y puede tener los mismos fallos relacionados con la memoria que los códigos de C 
y C++ si no es extremadamente cuidadoso con su forma de gestionar la memoria. 

En este capítulo, estudiaremos el modo no seguro del lenguaje C# y como 
puede ser usado para permitirle acceder directamente a las direcciones de memo¬ 
ria usando constructores de estilo puntero de C y C++. 

Conceptos básicos de los punteros 


En C# se accede a la memoria usando un tipo de dato especial llamado pun¬ 
tero. Un puntero es una variable cuyo valor apunta a una dirección específica de 
la memoria. En C#. un puntero se declara con un asterisco situado entre el tipo 
del puntero y su identificador. como se muestra en la siguiente declaración: 

int * MylntegerPointer; 

Esta instrucción declara un puntero entero llamado Mylnteger Pointer. 
El tipo del puntero indica el tipo de la variable a la que el puntero puede apuntar. 
Por ejemplo, un puntero entero sólo puede apuntar a memoria usada por una 
variable entera. Los punteros deben ser asignados a una dirección de memoria y 
C# hace que sea fácil escribir una expresión que evalúe la dirección de memoria 
de una variable. Si se antepone el operador de concatenación, el símbolo de unión, 
a una expresión unaria. devuelve una dirección de memoria, como muestra en el 
siguiente ejemplo: 

int Mylnteger = 12.3; 

int * MylntegerPointer = &MyInteger; 

El código anterior hace dos cosas: 

• Declara una variable entera llamada Mylnteger y le asigna el valor 

123. 
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• Declara una variable entera llamada MyIntegerPointer y la apunta 
en la dirección de la variable Mylnteger. 

La figura 19.1 muestra cómo se interpreta esta asignación en memoria. 

Mylnteger 


MylntegerPointer 

Figura 19.1. Un puntero apuntando a una variable 

Los punteros en realidad tienen dos valores: 

• El valor de la dirección de memoria del puntero 

• El valor de la variable a la que apunta el puntero 

C# permite escribir expresiones que evalúen cualquiera de los dos valores. Si 
se antepone un asterisco al identificador del puntero se obtiene el valor de la 
variable a la que apunta el puntero, como demuestra el siguiente codigo: 

int Mylnteger = 123; 

int * MylntegerPointer = ^Mylnteger; 

Consolé.WriteLine(*MyIntegerPointer); 

Este código escribe en la consola 12 3. 



Tipos de puntero 

Los punteros pueden tener uno de los siguientes tipos: 

• sbyte 

• byt e 

• short 

• ushort 

• int 


uint 




• 1 o n g 

• ulong 

• cha r 

• float 

• double 

• decimal 

• boo 1 

• un tipo de enumeración 

• void. usado para especificar un puntero para un tipo desconocido 

No se puede declarar un puntero para un tipo de referencia, como un objeto. 
La memoria para los objetos está gestionada por el CLR y la memoria puede ser 
borrada cada vez que el recolector de elementos no utilizados necesite liberar la 
memoria del objeto. Si el compilador de C# le permite mantener un puntero sobre 
un objeto, su codigo corre el riego de apuntar a un objeto cuya memoria puede ser 
liberada en otro punto por el recolector de elementos no utilizados del CLR. 

Imagine que el compilador de CU permitiese escribir código como el siguiente: 

MyClass MyObject - new MyClass(); 

MyClass + MyObjectPointer; 

MyObjectPointer = &MyObject; 

La memoria usada por MyObject es gestionada automáticamente por el CLR 
y su memoria es liberada cuando todas las referencias al objeto se liberan y se 
ejecuta el recolector de elementos no utilizados del CLR. El problema es que el 
codigo no seguro ahora contiene un puntero al objeto y el resultado es que tiene un 
puntero que apunta hacia un objeto cuya memoria se ha liberado. El CLR no tiene 
ningún modo de saber que hay un puntero para el objeto y el resultado es que. 
después de que el recolector de elementos no utilizados haya liberado la memoria, 
tiene un puntero apuntando hacia la nada. CU solventa este problema no permi¬ 
tiendo que existan variables a tipos de referencia con memoria que es gestionada 
por el CLR 


Cómo compilar código no seguro 


Por defecto, el compilador de CU sólo compila código seguro de CU. Para 
obligar al compilador a compilar código de CU no seguro debe usar el argumento 
del compilador /unsafe: 

esc /unsafe filel.es 
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El código no seguro permite escribir código que acceda directamente a la me¬ 
moria. sin hacer caso de los objetos que gestionan la memoria en las aplicaciones. 
Como a las direcciones de memoria se accede directamente, el código no seguro 
puede funcionar mejor en algunos tipos de aplicaciones. Esta instrucción compila 
el archivo fuente f ilel. es y permite compilar el codigo no seguro de C#. 


NOTA: En C#, el código no seguro permite declarar y usar punteros del 
mismo modo que en C++. 


Cómo especificar punteros en modo no seguro 

El compilador de C# no permite por defecto usar punteros en el código C 1 #. Si 
intenta trabajar con punteros en su código, el compilador de C# emitirá el siguien¬ 
te mensaje de error: 

error CS02I4: Los punteros sólo se pueden utilizar en un 

contexto no seguro 

Los punteros sólo son válidos en C# en código no seguro y hay que definir 
explícitamente el código no seguro al compilador. Para hacerlo se emplea la pala¬ 
bra clave de C# unsafe. La palabra clave unsafe debe aplicarse a un bloque 
de codigo que use punteros. 

Para especificar que un bloque de codigo se ejecute en el modo no seguro de 
C# se aplica la palabra clave unsafe a la declaración del cuerpo de codigo. 
como se muestra en el listado 19.1 

Listado 19.1. Métodos no seguros 


using System; 

public class MyClass 
{ 

public unsafe static void MainQ 
{ 

int Mylnteger = 123; 

int * MyIntegerPointer = iMylnteger; 

Consolé.WriteLine(*MyIntegerPointer); 

} 

} 

El método Main ( ) del listado 19.1 usa el modificador unsafe en su decla¬ 
ración. Esto indica al compilador de C# que todo el código del método debe ser 
considerado no seguro. Después de usar esta palabra clave, el código del método 
puede usar constructores de puntero no seguros 
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La palabra clave unsafe se aplica sólo al método en el que aparece. Si la 
clase del listado 19 1 va a contener otro método, esc otro método no podrá usar 
constructores de puntero no seguros a menos que. también, sea declarado con la 
palabra clave unsafe. Las siguientes reglas se aplican al modificador unsafe. 

• Clases, estructuras y delegados pueden incluir el modificador unsafe. 
que indica que todo el cuerpo del tipo se considera no seguro. 

• Campos, métodos, propiedades, eventos, indizadores. operadores, cons¬ 
tructores. destructores y constructores estáticos pueden definirse con el 
modificador unsafe, que indica que la declaración del miembro especifi¬ 
co no es segura. 

• Un bloque de código puede ser marcado con el modificador unsafe. que 
índica que todo el código debe ser considerado no seguro. 

Cómo acceder a los valores de los miembros 
mediante punteros 

El modo no seguro de C# permite usar el operador -> para acceder a los 
miembros de las estructuras a las que hace referencia el puntero. El operador, que 
se escribe como un guión seguido por el símbolo mayor que. le permite acceder 
directamente a los miembros, como se muestra en el listado 19.2. 

Listado 19.2. Cómo acceder a los miembros de una estructura con un puntero 

using System; 

public struct Point2D 
{ 

public int X; 
public int Y; 

} 

public class MyClass 
{ 

public unsafe static void Main() 

{ 

Point2D MyPoint; 

Point2D * PointerToMyPomt; 

MyPoint - new Point2D(); 

PointerToMyPoint = &MyPoint; 

PointerToMyPoint->X = 100; 

PointerToMyPoint->Y = 200; 

Consolé .WriteLme ( " ( { 0 } , { 1} ) " , PointerToMyPoint->X , 

PointerToMyPoint->Y); 
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El listado 19.2 contiene la declaración de una estructura llamada Point2D. 
La estructura tiene dos miembros públicos. El listado también incluye un método 
no seguro Main ( ) que crea una nueva variable del tipo de la estructura y crea un 
puntero para la nueva estructura. A continuación, el método usa el operador de 
acceso a miembros del puntero para asignar valores a la estructura, que se escribe 
en la consola. 

Esto es diferente del acceso a miembros del modo seguro, por defecto, de C#. 
que usa el operador . . Si se usa un operador incorrecto en un modo incorrecto, el 
compilador de C# emite un error. Si usa el operador . con un puntero no seguro, 
el compilador de C# emite el siguiente mensaje de error: 

error CS0023: El operador no se puede aplicar a operandos 

del tipo 'Point2D*' 

Si se usa el operador -> en un contexto seguro, el compilador de C# también 
emite un mensaje de error: 

error CS0193: El operador * o -> se debe aplicar a un puntero 

Cómo usar punteros para fijar variables 
a una dirección específica 


Cuando el CLR gestiona la memoria de una variable, el código trabaja con una 
variable v los detalles sobre la memoria de la variable son controlados por el 
CLR. Durante el proceso de recolección de elementos no utilizados del CLR. el 
tiempo de ejecución puede cambiar la memoria de lugar varias veces para afian¬ 
zar la pila de memoria disponible en tiempo de ejecución. Esto significa que 
durante el curso de una aplicación, la dirección de memoria para una variable 
puede cambiar. El CLR puede tomar los datos de la variable y moverlos a una 
dirección diferente. 

En condiciones normales, el código de C# no tiene en cuenta esta técnica de 
recolocación. Cómo el código trabaja con un identificador de variable, normal¬ 
mente accederá a la memoria de la variable mediante el identificador de la varia¬ 
ble v puede confiar en que el CLR trabaje con el fragmento de memoria correcto 
mientras trabaja con la variable. 

Sin embargo, la situación no es tan sencilla cuando se trabaja con punteros. 
Los punteros apuntan a una dirección de memoria específica. Si asigna un punte¬ 
ro a una dirección de memoria usada por una variable y el CLR después mueve la 
dirección de memoria de esa variable, su puntero estará apuntando a una memoria 
que ya no está siendo usada por la variable. 

El modo no seguro de C# permite especificar una variable como excluida de la 
recolocación de memoria del CLR. Esto permite mantener una variable en una 
dirección específica de memoria, lo que le permite usar un puntero con la variable 
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sin preocuparse de que el CLR pueda mover la dirección de memoria de la varia¬ 
ble de la dirección a la que apunta su puntero. Para especificar que la dirección de 
memoria de una variable debe ser fija se usa la palabra clave de CU f ixed. La 
palabra clave f ixed va seguida de una expresión entre paréntesis que contiene 
una declaración de puntero con una asignación a una variable. La expresión fija¬ 
da va seguida de un bloque de código y la variable fijada permanece en la misma 
dirección de memoria a lo largo del bloque de código fijado, como se muestra en 
el listado 19.3. 


Listado 19.3. Cómo fijar en memoria los datos gestionados 

using System; 

p u b 1 1 c c t a s s M y C1 a s s 
í 

pubJic u lis afe static voicl Main () 

{ 

int ArrayIndex; 
int [] IntegerArray; 

IntegerArray - new int [ój; 

f ixed !mt * IntegerPomter = IntegerArray) 
í 

t or (Ar r ay Index - 0; Arraylndex < 5; Ar raylnclex + + ) 

IntegerPomter 'Arraylndex] = Arraylndex; 

í- 

for(Arraylndex - 0; Arraylndex < 5; Arraylndex++J 

c: or. s o Ic.Wr iteLine (IntegerArray [Arraylnde x: j;) ; 

} 

} 


La palabra clave f ixed del listado 19.3 declara un puntero entero que apunta 
a una matriz entera. Va seguida por un bloque de codigo que escribe valores en la 
matriz usando un puntero. Dentro de este bloque de código, está garantizado que 
la dirección de la matriz IntegerArray es fija y que el CLR no moverá su 
posición Esto permite al código usar un puntero con la matriz sin preocuparse de 
si el CLR va a mover la posición de la memoria física de la matriz. Después de 
que el bloque de codigo fijado termine, ya no puede usarse el puntero y el CLR 
vuelve a tener en cuenta a la variable IntegerArray cuando reubica la memo¬ 
ria. 

Sintaxis del elemento de matriz puntero 

El listado 19.3 también muestra la sintaxis del elemento de matriz puntero. La 
siguiente línea de codigo trata un puntero de modo no seguro como si fuera una 
matriz de bytes: 

IntegerPointer[Arraylndex] = Arraylndex; 
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Esta linca de código trata al puntero como si fuese una matriz. La sintaxis del 
elemento de matriz puntero permite al código de C# no seguro ver la memoria a la 
que apunta el puntero como una matriz de variables en la que se puede escribir y 
leer de ella. 

Cómo comparar punteros 

El modo no seguro de C# permite comparar punteros usando los siguientes 
operadores: 

• Igualdad (==) 

• Desigualdad ( I= =) 

• Menor que (<) 

• Mayor que (>) 

• Menor o igual que (<-) 

• Mayor o igual que (>=) 

Al igual que los tipos de valores, estos operadores devuelven los valores 
booleanos True y False cuando se usan con tipos de puntero. 

Cálculo con punteros 

Se pueden combinar punteros con valores enteros en expresiones matemáticas 
para cambiar la posición a la que apunta el puntero. El operador + suma un valor 
al puntero y el operador - resta un valor del puntero. La instrucción f ixed del 
listado 19.3 también puede escribirse como se indica a continuación: 

fixed(int * IntegerPointer = IntegerArray) 

{ 

i or(Arraylndex = 0; Arraylndex < 5; Arraylndex++) 

*(IntegerPointer + Arraylndex) = Arraylndex; 

} 


En este bloque de código, el puntero es desplazado por un valor y la suma se 
usa para apuntar a una dirección de memoria. La siguiente instrucción realiza 
aritmética de puntero: 

MIntegerPointer + Arraylndex) = Arraylndex; 

Esta instrucción debe interpretarse como: "Toma el valor de Integer- 
Pointer e increméntalo en el número de posiciones especificadas por 
Arraylndex. Coloca el valor de Arraylndex en esa posición". 

La aritmética de puntero aumenta la posición de un puntero en un numero 
especificado de bvtes. dependiendo del tamaño del tipo al que se está apuntando. 
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El listado 19.3 declara una matriz entera y un puntero entero. Cuando se usa 
aritmética de puntero en el puntero entero, el valor usado para modificar el punte¬ 
ro especifica el número de tamaños de variable que deben moverse, no el número 
de bvtes. La siguiente expresión usa aritmética de puntero para desplazar la loca¬ 
lización de un puntero en tres bvtes: 

IntegerPointer + 3 

El valor literal 3 de esta expresión especifica que se debe incrementar el 
puntero en el espacio que ocupan tres números enteros, no en tres bvtes. Dado 
que el puntero apunta a un numero entero, el 3 se interpreta como "espacio nece¬ 
sario para tres números enteros" y no "espacio para tres bvtes". Dado que un 
número entero ocupa cuatro bvtes de memoria, la dirección del puntero se au¬ 
menta en doce bvtes (tres números enteros multiplicado por cuatro bvtes por 
cada número entero), no en tres. 

Cómo usar el operador sizeof 

Se puede usar el operador sizeof en modo no seguro para calcular el nu¬ 
mero de bvtes necesarios para contener un tipo de datos específico. El operador 
va seguido por un nombre de tipo no administrado entre paréntesis y la expresión 
da como resultado un numero entero que especifica el número de bvtes necesa¬ 
rio para contener una variable del tipo especificado. La tabla ló. 1 enumera los 
tipos administrados admitidos y los valores que devuelve una operación sizeof. 

Tabla 19.1. Tipos sizeof() admitidos 


Expresión 

Resultado 

sizeof(sbyte) 

1 

sizeof(byte) 

1 

sizeof(short) 

2 

sizeof(ushort) 

2 

sizeof(int) 

4 

sizeof(uint) 

4 

sizeof(long) 

8 

sizeof(ulong) 

8 

sizeof(char) 

2 

sizeof(float) 

4 

sizeof(double) 

8 

sizeof(bool) 

1 
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Cómo asignar espacio de la pila 
para la memoria 


C# proporciona un sencillo mecanismo de asignación de memoria en código no 
seguro. Puede solicitar memoria en modo no seguro usando la palabra clave de 
C# stackalloc. como se muestra en el listado 19.4. 

Listado 19.4. Cómo asignar espacio de la pila para la memoria 

using System; 

public class MyClass 
{ 

public unsafe static void Main 0 
{ 

int * CharacterBuffer = stackalloc int [5]; 
int Index; 

for(Index - 0; Index < 5; Index+t) 

CharacterBuffer[Index] - Index; 
for (Index = 0; Index < 5; Index + t) 

Consolé.WriteLine(CharacterBuffer[Index]); 



Tras la palabra clave stackalloc se escribe un tipo de dato. Devuelve un 
puntero al bloque de memoria al que se le asigna el espacio y se puede usar la 
memoria exactamente igual que la memoria gestionada por el CLR. 

No hay una operación explícita para liberar la memoria asignada por la pala¬ 
bra clave stackal loe. La memoria se libera automáticamente cuando finaliza 
el método que asignó esa memoria. 

Resumen 

El modo no seguro de C# permite a su codigo trabajar directamente con la 
memoria. Su uso puede mejorar el rendimiento porque el código accede directa¬ 
mente a la memoria, sin tener que moverse con cuidado por el CLR. Sin embargo, 
el modo no seguro puede ser peligroso y puede hacer que el codigo talle si no 
trabaja adecuadamente con la memoria. 

En general, evite el uso del modo no seguro de C#. Si necesita un poco más de 
rendimiento para su código o si está trabajando con código heredado de CoC++ 
que necesita que especifique una posición de memoria, siga con el modo seguro 
que se ofrece por defecto y deje que el CLR gestione los detalles de la asignación 
de memoria. 


419 



La pequeña reducción en el rendimiento que se produce es compensada con 
creces por no tener que realizar la pesada tarca de gestionar la memoria de su 
código v por conseguir la posibilidad de escribir código libre de errores relaciona¬ 
dos con la gestión de memoria. 
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20 


Constructores 

avanzados 

de C# 


En este capítulo examinaremos algunas facetas interesantes del lenguaje C#. 
También veremos algunos ejemplos de código y aprenderemos por qué el codigo 
funciona como lo hace. La comprensión de problemas de programación como los 
presentados en este capítulo le ayudarán a enfrentarse a sus propias dudas sobre 
programación en C#. 

En primer lugar, observe la función de conversión implícita de C# y cómo se 
aplica a objetos de clases derivadas a las que se accede como objetos de la clase 
base de la clase derivada. Recuerde que puede escribir métodos de operadores 
implícitos que definan cómo se gestionan las conversiones implícitas de un tipo u 
otro; pero, como verá, las cosas se vuelven un poco más complicadas cuando se 
trabaja con tipos de tiempo de ejecución y de tiempo de compilación. 

A continuación, nos adentraremos en la inicialización de estructuras. Las es¬ 
tructuras. al igual que las clases, pueden contener campos y propiedades. Sin 
embargo, la inicialización de estructuras con campos se realiza de forma ligera¬ 
mente diferente a la inicialización de estructuras con propiedades. En este capítu¬ 
lo. descubrirá por que y cómo resolver este problema. 

En la tercera parte de este capítulo, investigaremos el paso de un objeto de una 
clase derivada a una llamada de método en el que se espera un objeto de una clase 
base. Dado que los objetos de las clases derivadas son inherentemente objetos de 
la clase base, pasar un objeto de clase derivada a un elemento que espera una 
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clase base puede parecer bastante sencillo. En este apartado estudiaremos por que 
esta técnica no es tan simple como podría parecer. 

Finalmente, nos adentraremos en el uso avanzado de los indizadores de clase. 
En la inmensa mayoría de los casos, los indizadores que escriba servirán para 
hacer que una clase se comporte como una matriz de elementos. Por lo general, 
las matrices aceptan valores enteros como para especificar el elemento del índice. 
En este apartado estudiaremos la técnica de usar tipos de datos distintos de ente¬ 
ros para los índices de matriz. 


Operadores implícitos y conversiones 
no válidas 

Recuerde que las clases pueden contener un código de conversión de operado¬ 
res implícitos. Los operadores implícitos se usan para convertir un tipo en otro 
sin ningún código especial. En el lenguaje C# se crean muchas conversiones im¬ 
plícitas. Por ejemplo, un entero puede ser convertido implícitamente en un entero 
long sin ningún codigo especial: 

Mylnt - 123; 

long MyLonglnt = Mylnt; 

C# no define conversiones implícitas para todas las combinaciones existentes 
de tipos de datos. Sin embargo, puede escribir código de conversión de operado¬ 
res implícitos que indique al entorno común de ejecución (CLR) como debe com¬ 
portarse cuando un usuario de la clase intente hacer una conversión implícita 
entre la clase y otro tipo. En este apartado estudiaremos una faceta del operador 
de conversión implícita que trata con la conversión entre dos clases diferentes. 

El listado 20.1 contiene dos clases: TestClass y MainClass. La clase 
MainClass contiene el método Main ( ) de la aplicación. La clase TestClass 
contiene una variable privada de tipo MainClass. También define un método 
de operador implícito que convierte los objetos TestClass en objetos 
MainClass. La implementación de operador implícito devuelve una referencia 
al objeto privado MainClass del objeto TestClass. 

Listado 20.1. Excepciones a las conversiones inválidas con operadores implícitos 

public class TestClass 

{ 

private MainClass MyMainClassObject; 

public TestClass() 

{ 

MyMainClassObject - new MainClass(); 

} 
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public static implicit operator MainClass(TestClass Source) 
{ 

return Source.MyMarnC1 assObj ect; 

} 


public class MainClass 
{ 

public static void Main() 

{ 

object MyObject; 

MainClass MyMainClassObject; 

MyObject - new TestClass(); 

MyMainClassObject = (MainClass)MyObject; 


) 

El codigo del método Main ( ) crea un nuevo objeto TestClass y convierte 
explícitamente el objeto en otro objeto de tipo MainClass. Como en TestClass 
se define un operador implícito, esta conversión debe tener éxito. Sin embargo, si 
ejecuta el listado 20.1. recibirá el siguiente mensaje en la consola: 

Excepción no controlada: System.InvalidCastException: La 

conversión especificada no es válida, 
at MainClass.Main() 

¿Por qué el CLR considera que la conversión es inválida, incluso cuando se 
define un operador implícito? El problema aquí es que la conversión funciona 
entre tipos de tiempo de compilación, no entre tipos de tiempo de ejecución. 

El método Main ( ) crea un nuevo objeto de tipo TestClass y asigna el 
nuevo objeto a la variable de tipo object. A continuación, esta variable se 
convierte en un tipo de clase MainClass. Como el objeto fue creado como un 
objeto de tipo TestClass. puede esperar que la conversión explícita convierta 
un objeto de tipo TestClass en un objeto de tipo MainClass. 

Sin embargo. C# no realiza conversiones explícitas basadas en el tipo usado en 
el momento de crear el objeto. En su lugar, realiza conversiones basadas en el tipo 
de variable que contiene el nuevo objeto. En el listado 20.1. el nuevo objeto se 
asigna a una variable de tipo object. Por tanto, el compilador de C# genera 
código que convierte un objeto de tipo object a tipoMa i nClass. Como no se 
ha definido una conversión de ob j ect aMainClass. no se produce la conver¬ 
sión explícita. 

Inicialización de estructuras 

Como sabe, las estructuras pueden contener constructores de lenguaje que 
también se encuentran en las clases, incluyendo métodos, campos y propiedades. 
Para asignar valores a los métodos y campos de una estructura se usa una simple 
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instrucción de asignación. Sin embargo, es importante recordar que la diferencia 
entre una propiedad y un campo es que si se asigna un valor a una propiedad, se 
ejecuta el codigo compilado en la estructura. Esto significa que se debe tener 
especial cuidado cuando se asignan valores a propiedades de estructuras recién 
creadas. Este capítulo estudia este tema. 

Cómo inicializar estructuras 

El listado 20.2 contiene dos estructuras. La primera recibe el nombre de 
StructWi thPublicMembers y contiene dos miembros públicos enteros lla¬ 
mados X e Y. La segunda estructura se llama StructWithProperties \ 
contiene propiedades publicas llamadas X e Y. que gestionan dos números enteros 
privados. 

El método Main ( ) del listado 20.2 crea dos variables, una que tiene el tipo de 
estructura StructWithPublicMembers y otra que tiene el tipo de estructu¬ 
ra StructWi thPropert ies. El codigo asigna valores a los miembros X e Y 
de cada estructura. 

Listado 20.2. Cómo acceder a las estructuras con propiedades y métodos públicos 

public struct StructWithPublicMembers 

{ 

public int X; 
public int Y; 

} 


public struct StructWithProperties 
{ 

prívate int PrivateX; 
private int PrivateY; 

public int X 
{ 

ge t 

í 

return PrivateX; 

} 

set 

í 

PrivateX - valué; 

} 

} 


public int Y 
{ 

ge t 
{ 

return PrivateY; 

} 
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set 


í 

PrivateY = valué; 

} 



public class MainClass 

{ 

public static void Main() 

{ 

StructWithPublicMembers MembersStruct; 

Membe rsStruct.X = 100; 

MembersStruct.Y = 200; 

PropertiesStruct . X - 100; 


} 

El listado 20.2 no se compila. El compilador de C# emite el siguiente error: 

error CS0165: Uso de la variable local no asignada 

' PropertiesStruct' 

Lo mas interesante de este error es que hace referencia a la segunda variable de 
estructura definida en el método Main ( ) . Sin embargo, el compilador de CU 
compila el código que funciona con la primera variable de estructura. En otras 
palabras, se puede acceder a los miembros públicos del listado 20.2. pero no a las 
propiedades publicas del listado 20.2. ¿Cuál es la diferencia* 

Cómo resolver los problemas 
con la inicialización 

La respuesta corta es que el código debe usar el operador new para crear una 
nueva instancia de estructura. El listado 20.2 se compila si se crean nuev as refe¬ 
rencias de estructura: 

StructWithPropertiesPropertiesStruct = new 

StructWithProperties(); 

Esta respuesta tiene que ver con el hecho de que las propiedades son 
implcmentadas por el compilador de CU como funciones públicas cuando genera 
el eodigo del lenguaje intermedio de Microsoft (MS1L) para la aplicación. Puede 
comprobar esto revisando el MSIL generado por el compilador de CU. NET 
Framework tiene una herramienta llamada ILDASM. que son las siglas de 
desensamblador de IL Se puede usar esta herramienta para examinar el Lenguaje 
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intermedio (IL) y los metadatos de cualquier resultado binario compatible con el 
CLR de un compilador NET 

Modifique el listado 20.2 para que incluya la nueva operación y compílelo en 
un ejecutable llamado Listing2 0-2 .exe. Tras generar el ejecutable, puede 
observar su contenido con 1LDASM. Use la siguiente línea de comando para 
iniciar el desensamblador IL con el ejecutable del listado 20.2: 

ildasm Listing20-2.exe 

La figura 20.1 muestra la ventana ILDASM abierta con el ejecutable 
Listing20-2.exe. El ejecutable contiene el manifiesto, que incline la infor¬ 
mación de identificación para el ejecutable y también contiene metadatos que 
describen el código del ejecutable. 



Figura 20.1. ILDASM abierto con el ejecutable del listado 20.2 

ILDASM muestra las clases y estructuras del ejecutable en forma de árbol. La 
parte del árbol StructWithPublicMembers muestra dos variables publi¬ 
cas de tipo int3 2 llamadas X e Y. Estas variables reflejan las dos propiedades 
programadas en la estructura.La parte del árbol StructWithProperties 
muestra las dos variables privadas; también muestra cuatro métodos que no se 
escribieron en la estructura: 


• int32get_X() 

• int32get_Y() 



• void sct_X(int32) 

• void set_Y(int32) 

Estos métodos realmente implementan el acceso a la propiedad de la estructu¬ 
ra. El método get_X ( ) contiene el código del descriptor de acceso get de la 
propiedad X v el método get Y ( ) contiene el código del descriptor de acceso 
get de la propiedad Y. Del mismo modo, el método set X ( ) contiene el código 
del descriptor de acceso set de la propiedad X y el método set_Y ( ) contiene el 
código del descriptor de acceso set de la propiedad Y. Esto significa que cuando 
el código accede a una propiedad, en realidad está llamando a un método que 
implementa la funcionalidad de la propiedad 

El problema con el listado 20.2 es que la variable Propert iesStruct no 
esta imcializada con un operador new antes de ser usada. Esto significa que la 
variable no está asociada a una instancia de estructura y los métodos no pueden 
ser llamados en instancias que no existen. 

Las instrucciones de la propiedad del método Main ( ) obligan a que se llame 
a los métodos de propiedades subyacentes, pero la llamada no encuentra ninguna 
instancia. El compilador de C# detecta este problema y emite el mensaje de error 
mostrado tras el listado 20.2. 

La inicialización del miembro público tiene éxito porque las clases v las es¬ 
tructuras pueden imcializarse directamente, sin usar un constructor, siempre > 
cuando se haya dado explícitamente un valor a todas las v ariables de la instancia. 

Clases derivadas 


Cuando tratamos las clases de C# vimos cómo las clases pueden derivarse de 
otras clases. Las clases derivadas heredan la funcionalidad de su clase primaria o 
base La relación entre una clase derivada y una clase base recibe el nombre de 
una relación "es un" en términos orientados a objetos. Por ejemplo, todas las clase 
de CU derivan en ultima instancia del tipo System. Ob j ect de NET. de modo 
que se puede decir que la clase "es un" System. Ob j ect. 

Como todas las clases derivadas heredan funcionalidad de su clase base, pode¬ 
mos presuponer que los objetos de una clase derivada pueden ser usados en cual¬ 
quier lugar donde se pueda usar un objeto de la clase base de la clase. Sin embargo, 
la seguridad de tipo integrada en C# tiene preferencia y el código de este apartado 
explica este tema. 

Cómo pasar clases derivadas 

El listado 20.3 contiene una clase llamada TestClass que contiene un mé¬ 
todo llamado Test ( ) . El método Test ( ) acepta una referencia a un objeto 
como parámetro. 
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El listado 20.3 también contiene una clase llamada MainClass. que crea un 
objeto de la clase TestClass y una cadena. La cadena se usa como parametro 
para la llamada al método Test ( ) del objeto TestClass. 

Listado 20.3. Cómo pasar cadenas donde se esperan objetos 

public class TestClass 
{ 

public voici Test(ref ob]ect ObjectRef erence) 

{ 

} 

} 


public class MainClass 
{ 

public static void Main() 

{ 

TestClass TestObject = new TestClass() ; 
string TestString = "Helio from C# ! " ; 

TestObject.Test(ref TestString); 



El listado 20.3 no se compila. El compilador de CU emite los siguientes erro¬ 
res: 


Listing20 - 3.es ( 1 6,9) : error CS1502: La mejor coincidencia de 
método sobrecargado para TestClass.Test(ref object)' tiene 
algunos argumentos no validos 

Listing20-3.cs (1c,29) : error CS15Q3: Argumento '1' : no se puede 
convertir de 'ref string' a 'ref object' 

A primera vista, no parece logico. Como cada tipo de dato de NET es un 
objeto, cualquier tipo de dato debería convertirse en ultima instancia en una va¬ 
riable de tipo object. Esto debería incluir a los objetos string. ¿Por que no 
se puede convertir implícitamente el objeto string en una variable de tipo 

o b j e c t 

Cómo resolver problemas que surgen cuando 
se pasan clases derivadas 

El problema de compilación surge de las estrictas reglas de seguridad de tipos 
integradas en el lenguaje CU. El método Test ( ) del listado 20.3 toma el valor de 
tipo object como parámetro y el compilador emite un error si se le proporciona 
algo distinto de un objeto. Otro problema con la estrategia del listado 20.3 proce¬ 
de del modificador de parámetro ref usado en el método Test ( ) . El modifica- 
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dor ref permite que la implementación del método cambie el valor de la variable 
v el cambio es visible para el invocador. Esto le da permiso al método Test ( ) 
para sobrescribir la variable Ob j ectRef erence con cualquier valor que pue¬ 
da volver a convertirse explícitamente en un objeto. Observe la siguiente 
implementación alternativa del método Test ( ) : 

public void Test (ref object ObjectReference) 

{ 

Téstelass TestObject; 

TestObj ect - new Téstelassf)| 

ObjectReference = (object)TestObject; 

} 

En esta implementación. se crea un objeto de clase TestClass. La variable 
de referencia Obj ectRef erence se asigna al nuevo objeto y el ¡mocador ve 
esta asignación. El problema es que el listado 20.3 pasa una cadena al método 
Test ( ) . Con esta nueva implementación del método Test ( ) situado en el 
listado 20.3. el invocador podría pasar una cadena y recuperaría un objeto 
TestClass. El invocador podría no esperar que la variable cambiara a un tipo 
diferente del suministrado y podrían surgir numerosos problemas si el invocador 
siguiera trabajando con el código presuponiendo que la variable sigue siendo una 
cadena. C# evita este problema exigiendo que solo se usen tipos de parámetros 
correctos cuando se invoquen métodos. 


Cómo usar no enteros como elementos 
de matriz 


El lenguaje C# especifica que solo se pueden usar enteros como elementos de 
matriz. Sin embargo, a veces se encontrará en situaciones en las que los enteros 
no son el modo más conveniente para expresar un índice de matriz en el codigo. 
Por ejemplo, imagine un tablero de ajedrez en el que una letra desde A hasta H 
hace referencia a una de las ocho columnas del tablero y un número de 1 a 8 hace 
referencia a una de las ocho filas del tablero. Si necesita representar un tablero de 
ajedrez en el codigo de C#. podría escoger usar una matriz rectangular de dos 
dimensiones: 

int [,] Chessboard; 

Chessboard = new int [8,8]; 

Tras inicializar la matriz del tablero de ajedrez, querrá hacer referencia a una 
casilla usando la tradicional sintaxis para las casillas del tablero de ajedrez Qui¬ 
zás quiera hacer referencia a la casilla B7. por ejemplo, de esta manera: 

Chessboard[ 'B ' , 7 ] ; 
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Sin embargo, no puede hacer esto porque C# no permite el uso de caracteres, 
como la B del ejemplo, como referencias de elementos de matriz. 

El listado 20.4 usa un indizador para solucionar este problema: 

Listado 20.4. Cómo representar un tablero de ajedrez con un indizador 

using System; 

public class Chessboard 

{ 

prívate int [,] Board; 

public Chessboard() 

{ 

Board = new mt[8,8] ; 

} 


public int this [char Column, int Rowlndexj 

{ 

ge t 

{ 

.int Column Index; 
switch(Column) 


case ' A' : 
case ' a ' : 

ColumnIndex - 0; 
break; 
case ' B' : 
case ' b ' : 

ColumnIndex = 1; 

break; 
case 'C' : 
case ' c' : 

ColumnIndex = 2; 
break; 
case ' D ' : 
case ' d' : 

ColumnIndex = 3; 
brea k; 
case 'E': 
case ' e' : 

ColumnIndex = 4; 

break; 
case ' F' : 
case ' f ' : 

Columnlndex = 5; 
break; 
case ' G' : 
case ' g' : 

Columnlndex = c; 
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b r e a k ; 
case 'H': 
case 'h': 

Columnlndex - 7; 

break; 
default: 

throw new Exception("IIlegal column specifíer."); 

} 

Consolé .WriteLme ( returmng cell [ { 0 } , { 1} ] " , 
Columnlndex, Rowlndex); 

return Board[Columnlndex, RowIndex]; 



public class MamClass 

{ 

public static void Main() 

{ 

int CellContents; 

Chessboard MyChessboard = new Chessboard ( ) ; 

CellContents = MyChessboard f'B', 7]; 

} 

} 

El código del listado 20.4 declara una clase llamada Chessboard para re¬ 
presentar un tablero de ajedrez. La clase incluye una matriz de enteros privada de 
dos dimensiones llamada Board. que puede usarse para representar que piezas 
de ajedrez están en qué casillas del tablero. (Para mantener el listado del código, 
la matriz no se usa realmente.) 

La clase también implementa un indizador con un descriptor de acceso get. 
El indizador acepta dos parámetros: un carácter y un entero. El indizador da por 
hecho que el carácter especificado en el primer parametro representa un 
identificador de columna v traduce el carácter como una columna de la matriz 
privada. El especificado!’ de columna A lo traduce como columna 0 en la matriz 
privada Board. El especificador de columna B lo traduce como columna 1 en la 
matriz privada Board \ así sucesivamente. El indizador escribe un mensaje en la 
consola que especifica los elementos de indizador traducidos y luego devuelve el 
valor de los elementos de la matriz a los que hacen referencia los parámetros del 
indizador. 

El método Main () del listado 20.4 crea un nuev o objeto de tipo Chessboard 
\ usa el indizador para hacer referencia a la casilla B7: 

CellContents = MyChessboard [ 'B' , 7] ; 

Cuando el código del listado 20.4 se ejecuta, el código del método Main ( ) 
llama al indizador. que escribe lo siguiente en la consola: 

(returmng cell [1,7] 
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El indizador tradujo el primer parámetro. B. en la referencia de columna basa¬ 
da en enteros que el compilador de C# necesita para acceder a un elemento de la 
matriz privada. Este esquema permite diseñar clases que usan una sintaxis natu¬ 
ral para la aplicación (en este caso, indizadores de elementos de matriz basados 
en caracteres) mientras aun cumplen los requisitos de C# de usar indizadores de 
elementos de matriz basados en enteros. 


Resumen 


El mejor modo de resolver un difícil problema de programación de C# es 
intentar diferentes métodos de codificación con el compilador. No tenga miedo de 
experimentar. El compilador de C# le av isara si hace algo equivocado. 

También podría considerar el uso la herramienta ILDASM para colarse en sus 
ensamblados y v er cómo el compilador de C# crea codigo ejecutable a partir de su 
código fuente. La comprensión del código que genera el compilador de C# puede 
ayudarle a entender por que el código funciona de la manera que lo hace. En este 
capítulo, aprendió que el código descriptor de acceso de propiedades se conv ierte 
en métodos especiales por el compilador de CU. Esto puede ser difícil de descubrir 
sin observar el codigo generado por ILDASM. La herramienta ILDASM funciona 
con cualquier ensamblado generado por un compilador de NET que genere MSIL. 
Examine con ILDASM algunos ensamblados y aplicaciones de NET. Ábralos 
con la herramienta y vea como están construidos. El análisis de otros ensambla¬ 
dos v su contenido puede darle una mejor comprensión de cómo funciona el códi¬ 
go NET v puede ayudarle a ser un mejor programador NET. 
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Parte IV 

Cómo 
desarrollar 
soluciones .NET 

usando C# 
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21 


Cómo 
construir 
aplicaciones 
WindowsForms 


La mayor parte del material escrito sobre .NET Framework se centra en la 
ayuda que reciben los programadores que escriben aplicaciones para Internet. El 
motor ASP.NET y los modelos de desarrollo del "software como un servicio" son. 
sin lugar a dudas, unas potentes herramientas para el desarrollo de aplicaciones 
de Internet. Sin embargo. NET Framework no trata sólo con Internet. 

Microsoft se dio cuenta de que. aunque muchos programadores están escn- 
biendo aplicaciones para Internet, otros muchos se dedican a desarrollar aplica¬ 
ciones de escritorio al estilo Win32. NET Framework no ha olvidado a estos 
programadores. Incluvc un conjunto de clases de NET que facilita el desarrollo 
de aplicaciones Windows de escritorio que usan un lenguaje compatible con NET. 
Este conjunto de clases y el modelo de programación que admite se llama 
WindowsForms. 

En este capítulo estudiaremos la estructura básica de una aplicación 
WindowsForms. Verá cómo crear una forma básica y cómo añadir controles a los 
formularios. 

Examinaremos las clases de NET Framework que puede usar una aplicación 
Window sForms y también estudiaremos algunos de los atributos de ensamblado 
que se pueden usar para agregar la información de versión y derecho de autoría a 
sus aplicaciones. 
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Arquitectura de WindowsForms 


Para programar una aplicación WindowsForms es necesario comprender cómo 
se usan las clases base de WindowsForms con las aplicaciones NET Este capítu¬ 
lo examina la arquitectura de la biblioteca de clases de WindowsForms. 

Todas las clases que se usan para construir aplicaciones de WindowsForms se 
incluyen en un espacio de nombre de NET Framework llamado System. 
Windows . Forms. Este espacio de nombre contiene todas las clases necesarias 
para construir elaboradas aplicaciones de escritorio para Windows. Estas clases 
permiten trabajar con formularios, botones, controles de edición, casillas de veri¬ 
ficación. listas y muchos otros elementos de interfaz de usuario. Todas estas 
clases están a su disposición listas para ser usadas en sus aplicaciones 
WindowsForms. 

Las aplicaciones WindowsForms usan dos clases fundamentales de NET 
Framework: La clase Form. que gestiona los formularios de la aplicación y los 
controles del formulario, y la clase Application, que gestiona el modo en que 
la aplicación controla los mensajes Windows enviados y recibidos de los formula¬ 
rios de la aplicación. Estas dos clases se incluyen en el espacio de nombre 
System. Windows . Forms de NET Framework y componen la estructura básica 
de una aplicación WindowsForms. 

La clase Form 

El espacio de nombre System. Windows . Forms incline una clase base 
llamada Form. La clase Form representa una forma o ventana de su aplicación 
Al crear una aplicación de WindowsForms en C#. se diseña una clase de ventana 
y se usa la clase Form como clase base para la clase de ventana. Esta clase de 
ventana hereda todo el comportamiento básico de una ventana y agrega la 
funcionalidad necesaria para la aplicación. Todos los comportamientos básicos 
de ventana están integrados en la clase base Form y esos comportamientos se 
heredan automáticamente si se deriva una clase de ventana de la clase Form. 

La clase Application 

Las clases Form definen el aspecto y comportamiento de las ventanas de una 
aplicación paro no se ejecutan por si mismas. WindowsForms debe ejecutarse 
dentro del contexto de una aplicación. El espacio de nombres System. 
Windows . Forms incluye una clase llamada Application, que contiene 
métodos que ayudan a gestionar las aplicaciones WindowsForms. 

La clase Application contiene métodos que permiten iniciar, gestionar v 
detener las aplicaciones WindowsForms. WindowsForms responde a eventos 
iniciados por el usuario, como mover el ratón o pulsar una tecla del teclado. 
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Desde los comienzos de Windows, la arquitectura de las aplicaciones de escrito¬ 
rio de Windows ha sido diseñada sobre el concepto de bucle de mensajes. 

En una aplicación Windows estándar, la parte mas importante del codigo se 
incluye en un bucle v recibe mensajes del sistema operativo VV indows. t uando el 
usuario mueve el ratón, pulsa una tecla o realiza alguna otra operación sobre la 
que puede actuar una ventana, el sistema operativo toma nota de la acción y en\ ía 
un mensaje a la ventana correspondiente informándole de la acción. Es el codigo 
de la ventana el que debe utilizar convenientemente el mensaje. 

En la arquitectura WindowsForms. los conceptos básicos siguen siendo los 
mismos. Las aplicaciones WindowsForms tienen un fragmento de codigo que 
espera la llegada de mensajes de interacción del usuario desde el sistema operati¬ 
vo v luego los envían a la ventana apropiada. En la arquitectura WindowsForms. 
la clase Application es el código principal que gestiona este control de men¬ 
sajes v la clase Forms es la clase que controla los mensajes que en\ía la clase 
Application. 

La clase Application está sellada. No se pueden derivar clases de ella. 
Sus métodos son estáticos, lo que significa que pueden ser llamados sin que haya 
un objeto de la clase Application disponible. 

Cómo crear la primera aplicación 
WindowsForms 

El listado 21.1 muestra una sencilla aplicación W indowsForms. Representa 
una sencilla aplicación WindowsForms que abre un sólo formulario y sigue ejecu¬ 
tándose hasta que el usuario cierra el formulario. 

Listado 21.1. La aplicación Helio, WindowsForms 

using System.Windows.Forms; 

public class SimpleHelloWorld : Form 

{ 

public static void Main() 

{ 

Application.Run(new SimpleHelloWorld()); 

} 


public SimpleHelloWorld() 

{ 

Text = "Helio, WindowsForms! 


} 

El código del listado 211 declara una clase llamada SimpleHelloWorld. 
Se deriva de la clase Form de NET Framework. que califica la clase como una 
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clase Windows Form. La clase contiene un método Main(). que crea un 
nuevo objeto de la clase SimpleHel loWor Id y usa ese objeto como parámetro 
del método en la clase Application llamado Run ( ) . El constructor de la 
clase SimpleHel loWorld establece el valor de la propiedad heredada Text 
a Helio, WindowsForms ! Esta cadena se muestra como el titulo del formu¬ 
lario La figura 21.1 muestra el aspecto del formulario cuando se ejecuta el códi¬ 
go del listado 21.1 



Figura 21.1. El listado 21.1 muestra un sencillo formularlo 

Cómo compilar una aplicación 
WindowsForms 

Al igual que las aplicaciones de consola diseñadas usando CU. las aplicaciones 
WindowsForms deben ser compiladas con el compilador de CU antes de poder 
ejecutar su código. Las aplicaciones WindowsForms compiladas con el compilador 
de C U pueden comportarse de forma ligeramente diferente al ser iniciadas, depen¬ 
diendo del modo en el que se compiló el código. La siguiente linea de comando es 
la mas simple que se puede usar para compilar el código del listado 21.1: 

cse Lis 1 1 n g 21- 1 .c s 

Como todas las aplicaciones de CU. este codigo genera un ejecutable llamado 
L i st. i ng2 1 -1 . e:-:e. Si ejecuta este archivo desde una consola, aparecerá la 
ventana de la aplicación. Sin embargo, ocurre algo interesante cuando se hace 
doble clic sobre el icono del ejecutable en el explorador de Windows. Si se inicia 
el ejecutable desde el Explorador de Windows aparecen dos ventanas: una v enta¬ 
na de consola, que esta vacía y la ventana WindowsForms de la aplicación. 
Este comportamiento es diferente de la mayoría de las aplicaciones Windows. La 
mayoría de las aplicaciones Windows no presentan una ventana de consola vacía 
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cuando se inicia la aplicación. ¿Por que el ejecutable del listado 21.1 muestra una 
ventana de consola y. lo más importante, como podemos eliminarla? 

Por defecto, el compilador de C# genera aplicaciones de consola. Estas aplica¬ 
ciones necesitan una ventana de consola para que los métodos, como 
Consolé . WriteLine (). dispongan de una consola en la que escribir sus 
mensajes. El tiempo de ejecución de .NET consulta el ejecutable cuando es inicia¬ 
do v si el ejecutable está compilado como una aplicación de consola, el cargador 
del tiempo de ejecución crea una nueva ventana de consola para la aplicación. Si 
se compila el listado 21.1 mediante el compilador de C# por defecto, se generara 
una aplicación NET para consola. Esto explica la ventana de consola vacia que 
aparece cuando se ejecuta el ejecutable compilado. 

WindovvsForms trabaja con ventanas, no con consolas y las aplicaciones 
WindowsForms no necesitan la ventana de consola. El compiladoi de C # admite 
un argumento de línea de comando llamado target que se usa para especificar 
el tipo de la aplicación que se quiere compilar. Puede usar este argumento para 
indicarle al compilador de C# que quiere compilar una aplicación Windows que 
no necesita una consola. La siguiente línea de comando: 

esc /target:winexe Listing21-l.cs 

ordena al compilador de C# que compile el archivo Listing2 1-l.cs y 
use sus contenidos para crear un ejecutable Windows que no necesita una con¬ 
sola. Si usa esta linea de comando para compilar el codigo del listado 21.1 e inicia 
el ejecutable desde el explorador de Windows, aparecerá el formulario de la 
aplicación, sin que aparezca también una ventana de consola vacía 

NOTA: El compilador de C# acepta /t como abreviatura de /target. 

La anterior línea de comandos puede acortarse a esc /t:winexe 

Listing21-l.cs. 


Ensamblados: cómo añadir información 
de versión a las aplicaciones WindowsForms 

Por defecto, las aplicaciones WindowsForms no contienen información de 
su versión. Sin embargo, se pueden usar atributos integrados en NET Framework 
para añadir información de la versión a las aplicaciones. Estos atributos empie¬ 
zan a actuar en el nivel de ensamblado y se añaden al código que produce el 
compilador de C#. Todos estos atributos son opcionales, pero su uso añade infor¬ 
mación de versión v de derechos de autoría a los binarios NET Al añadn esta 
información se permite a los usuarios finales usar el Explorador de Windows, 
hacer clic con el botón derecho en la aplicación, seleccionar Propiedades en el 
menú contextual e inspeccionar los v alores del atributo incrustado. Los usuarios 


441 




finales pueden examinar la información de la versión y de derechos de autoría de 
las aplicaciones NET Windows Forras exactamente del mismo modo que pue¬ 
den examinar dicha información en las aplicaciones Win32 estándar. 

Las clases que implementan estos atributos están en un espacio de nombre 
NET llamado System. Ref lection. Cuando se usan estos atributos, hay 
que hacer referencia a este espacio de nombre con la palabra clave using o 
anteponer el nombre del espacio de nombre a los nombres de los ensamblados. 

Parte de la información especificada en estos atributos se escribe en el mani¬ 
fiesto del ensamblado y otros fragmentos de información se almacenan como 
recurso de información de versión incrustado en el ejecutable del ensamblado. 
Puede observar el manifiesto del ensamblado mediante la herramienta ILDASM y 
puede ver el recurso de información de versión del ejecutable haciendo clic con el 
boton derecho del ratón en el archiv o en el Explorador de Windows y seleccionan¬ 
do Propiedades>Versión 


TRUCO: Puede agregar estos atributos a cualquier proyecto de código 
.NET. La información de la versión siempre está disponible en el producto 
compilado del código. 


En este apartado estudiaremos los siguientes atributos: 

• AssemblyTitle. que asigna un título al ensamblado. 

• AssemblyDescription. que asigna una descripción al ensamblado. 

• AssemblyConfiguration. que describe las opciones usadas para 
construir el ensamblado. 

• AssemblyCompany. que asigna un nombre de compañía al ensamblado. 

• Assernb LyProduct. que asigna información del producto al ensamblado. 

• AssemblyCopyright. que asigna información de derechos de autoría 
al ensamblado. 

• AssemblyTrademar k. que asigna información de marca al ensamblado. 

• AssemblyCulture. que asigna información local al ensamblado. 

• AssemblyVersion. que asigna un numero de versión al ensamblado. 

AssemblyTitle 

El atributo AssemblyTitle permite asignar un título al ensamblado. El 
atributo toma un parametro de cadena en su constructor que especifica el título, 
como muestra el siguiente ejemplo: 

[assembly: AssemblyTi11e ( " Listing 21-2")] 
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El título del ensamblado no se escribe en su manifiesto, pero está disponible en 
el campo Description del bloque de información de versión del archivo com¬ 
pilado. 

AssemblyDescription 

El atributo AssemblyDescription permite proporcionar una descrip¬ 
ción del ensamblado. El atributo toma un parámetro de cadena en su constructor 
que especifica la descripción, como muestra el siguiente ejemplo: 

[assembly: AssemblyDescription("This executable was produced by 
compiling the code in Listing 21-2.")] 

La descripción del ensamblado se escribe en el manifiesto del ensamblado, 
también está disponible en el campo Comment del bloque de información de 
versión del archivo compilado. 

AssemblyConfiguration 

El atributo AssemblyConfiguration permite especificar infoimación 
de configuración de compilación del ensamblado. Por ejemplo, la información de 
configuración de ensamblado puede especificar si el ensamblado se compiló con 
configuración para su distribución o depuración. El atributo toma un parámetro 
de cadena en su constructor que especifica la información de configuración 

[assembly: AssemblyConfiguration("retail")} 

La descripción del ensamblado se escribe en el manifiesto del ensamblado, 
pero no esta disponible en el bloque de información de versión del archivo compilado. 

AssemblyCompany 

El atributo AssemblyCompany permite especificar un nombre de compañía 
para asociarlo al ensamblado. El atributo toma un parámetro de cadena en su 
constructor que especifica el nombre de la compañía: 

[assembly: AssemblyCompany("John Wiley, Inc.")] 

El nombre de la compañía del ensamblado se escribe en el manifiesto del en¬ 
samblado; también está disponible en el campo Company Ñame del bloque de 
información de versión del archivo compilado. 

AssemblyProduct 

El atributo AssemblyProduct permite especificar un nombre de producto 
para asociarlo al ensamblado. El atributo toma un parámetro de cadena en su 
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constructor que especifica el nombre del producto compañía, como muestra el 
siguiente ejemplo: 

[assembly: AssemblyProduct("C# Bible")] 

El nombre del producto del ensamblado se escribe en el manifiesto del ensam¬ 
blado; también está disponible en el campo Product Ñame del bloque de 
información de versión del archivo compilado. 

AssemblyCopyright 

El atributo AssemblyCopyright permite especificar información de dere¬ 
chos de autoría para el ensamblado. El atributo toma un parámetro de cadena en 
su constructor que especifica la información de derechos de autoría, como mues¬ 
tra el siguiente ejemplo: 

[assembly: AssemblyCopyright("(c) 2002 John Wiley, Inc.")] 

El nombre del producto del ensamblado se escribe en el manifiesto del ensam¬ 
blado; también está disponible en el campo Copyright del bloque de informa¬ 
ción de versión del archivo compilado. 

AssemblyTrademark 

El atributo AssemblyTrademark permite especificar información de mar¬ 
ca registrada para el ensamblado. El atributo toma un parámetro de cadena en su 
constructor que especifica la información de marca registrada, como muestra el 
siguiente ejemplo: 

[assembly: AssemblyTrademark("Windows is a trademark of 

Microsoft Corporation.")] 

El nombre del producto del ensamblado se escribe en el manifiesto del ensam¬ 
blado; también está disponible en el campo Legal del bloque de información de 
versión del archivo compilado. 

AssemblyCulture 

El atributo AssemblyCulture permite especificar información de referen¬ 
cia cultural para el ensamblado. 

La información de referencia cultural especifica la información de lenguaje y 
país que el ensamblado usa para hacer su trabajo. El atributo toma un parámetro 
de cadena en su constructor que especifica la información de referencia cultural 
como muestra el siguiente ejemplo: 

[assembly: AssemblyCulture("us-en")] 
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Las cadenas de referencia cultural son definidas mediante un estándar de Internet 
llamado RFC 1766. El estándar se titula Tags for the Identification 
of Languages y está disponible en Internet en www.ietf.org/rfc/ 
rfcl7 66.txt. El nombre del producto del ensamblado se escribe en el mani¬ 
fiesto del ensamblado; también está disponible en el campo Legal Trademarks 
del bloque de información de versión del archivo compilado. 


NOTA: La información de referencia cultural sólo se puede añadir a bi¬ 
bliotecas y módulos. No puede añadirse a ejecutables, porque los ejecutables 
no pueden ser localizados. Si se intenta añadir el atributo Assembly- 
Culture al código base que se compila en el ejecutable final, el compilador 
de C# emite el siguiente mensaje de error: 


error CS0647: Error al emitir el atributo 

'System.Reflection.AssemblyCultureAttribute'Los archivos 

ejecutables no se pueden adaptar y no deben tener referencia 

cultural' 

La descripción del ensamblado se escribe en el manifiesto del ensamblado, 
pero no está disponible en el bloque de información de versión del archivo compi¬ 
lado. 

AssemblyVersion 

El atributo AssemblyVersion permite asignar un numero de versión al 
ensamblado. Los números de versión de NET constan de cuatro partes: 

• Un numero de versión principal 

• Un numero de versión secundaria 

• Un número de revisión 

• Un número de compilación 

Cada una de estas partes está separada por un punto. El atributo toma un 
parámetro de cadena en su constructor que especifica el número de versión, como 
muestra el siguiente ejemplo: 

[assembly: AssemblyVersion("1.0.0.0")] 

Siempre se debe especificar un número de versión. Si se especifican los núme¬ 
ros de versión principal y secundaria, puede dejar que el compilador de C# genere 
automáticamente los otros números al compilar el código. Esto puede ser útil si se 
quiere que cada compilación del código tenga un número de versión único. Si usa 
el carácter asterisco para un numero de compilación, el compilador de C# asigna 


445 




uno automáticamente. El numero de compilación generado es igual al numero de 
días desde el 1 de enero del 2000. como muestra el siguiente ejemplo: 

[assembly: AssemblyVersión(”1.0.0.*")] 

Este ejemplo asigna al ensamblado una versión principal igual a 1. una versión 
secundaria igual a 0. un número de revisión igual a 0 y un número de compilación 
asignado automáticamente por el compilador de C#. 

Si usa el carácter asterisco para un número de revisión, el compilador de C# 
asigna automáticamente un número de revisión y un número de compilación. El 
número de revisión generado es igual al número de días desde el 1 de enero del 
2000. como muestra el siguiente ejemplo: 

[assembly: AssemblyVersion("1.0.*”)] 

Este ejemplo asigna al ensamblado una versión principal igual a 1. una versión 
secundaria igual a 0. un numero de revisión igual a 0 y un número de revisión 
asignado automáticamente por el compilador de C#. 

El nombre del producto del ensamblado se escribe en el manifiesto del ensam¬ 
blado: también esta disponible en los campos Assembly Versión. Product 
Versión v File Versión del bloque de información de versión del archivo 
compilado. El listado 2 1.2 añade atributos de versión de ensamblado al código del 
listado 21.1. 


Listado 21.2. Sencilla aplicación de formulario Windows con información de versión 


using System.Reflection; 
using System.Windows.Forms; 


[assembly: 
[assembly: 
compilmg 
[ a s s e mb 1 y : 
[assembly: 
[ass embly: 
[assembly: 
[assembly: 


As semb 1 yT ítle ("List mg 21-2") ] 

Assemb1yDescription("This executable was 
the code in Listín g 21-2.") ] 

As semblyConfiguration("Retaíl") ] 
AssemblyCompany("John Wiley, Inc.")] 
AssemblyProduct (" C# Bible")] 
AssemblyCopyright (" (c ) 2002 John Wiley, 

AssemblyVersion("1.0.*"} ] 


produced 


Inc.") ] 


by 


public elass SimpleHelloWorld : Form 
{ 

public static void Main() 

{ 

Application.Run (new SimpleHelloWorId () ) ; 

} 


public SimpleHe1loWorld() 

{ 

Text - "Helio, WindowsForms! 


} 
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El objeto Application con más detalle 

El objeto Application contiene propiedades, métodos y eventos que pue¬ 
den usarse en el codigo WindowsForms. En este apartado estudiaremos los 
miembros de clase más usados. 

Eventos Application 

La clase Application admite cuatro eventos que pueden usarse en las 
aplicaciones WindowsForms: 

• El evento App 1. i cat i onEx i t se desencadena cuando la aplicación esta 
a punto de cerrarse. A este evento se le pueden asignar los delegados de 
tipo EventHandler . El delegado EventHandler esta definido en el 
espacio de nombre System de NET. El delegado toma dos parámetros: un 
objeto que hace referencia al objeto que envía el evento y un objeto 
EventArgs que especifica los argumentos del evento No devuelve nin¬ 
gún valor. 

• El ev ento Id le se desencadena cuando la aplicación termina de env iar 
mensajes desde el sistema operativo y está a punto de entrar en estado de 
inactividad. La aplicación abandona el estado de inactividad cuando consi¬ 
dera que hay más mensajes que procesar. A este evento se le pueden asig¬ 
nar delegados de tipo EventHandler. El delegado EventHandler 
está definido en el espacio de nombre .NET System. El delegado toma 
dos parámetros: un objeto que hace referencia al objeto que envía el ev ento 
v un objeto EventArgs que especifica los argumentos del evento. No 
devuelve ningún valor. 

• El evento ThreadExcept ion se desencadena cuando se inicia una ex¬ 
cepción de subproceso no capturada. A este evento se le pueden asignar 
delegados de tipo ThreadExecptionEventHandler. El delegado 
ThreadExecpt ionEvent Hand ler se define en el espacio de nom¬ 
bre .NET System. Threading. El delegado toma dos parámetros: un 
objeto que hace referencia al objeto que envía el evento y un objeto 
ThreadingExcept ronEventArgs que especifica los argumentos del 
evento. No devuelve ningún valor. 

• El evento ThreadExit se desencadena cuando un subproceso está a 
punto de cerrarse. Cuando el proceso principal de una aplicación está a 
punto de cerrarse, antes se desencadena este ev ento, seguido de un evento 
ApplicationExit . A este evento se le pueden asignar delegados de 
tipo EventHandler. El delegado EventHandler está definido en el 
espacio de nombre System de .NET. El delegado toma dos parámetros: 
un objeto que hace referencia al objeto que envía el evento y un objeto 
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EventArgs que especifica los argumentos del evento. No devuelve nin¬ 
gún valor. 


Cómo trabajar con eventos en el código 

El codigo del listado 21.3 se suma al código de formulario del listado 21.2 
mediante el control de eventos desde el objeto Application. 

Listado 21.3. Cómo controlar los eventos de la aplicación 

usincj System; 
using System.Threading; 
using System.Reflection; 
u s i n g System.Wind ows.Fo rms ; 

[assembly: AssemblyTitle("Listing 21-3")] 

[assembly: AssemblyDescríption("This executable was produeed by 
compilmg the code in List ing 21-3.")] 

[assembly: AssemblyCompany{"John Wiley, Inc.")] 

[assembly: AssemblyProduct("C# Bible")] 

[assembly: As s emblyCopy r i ght ( " (c ) 2002 John Wiley, Inc."')] 

[ a s s e rnb i y : As s emb 1 y Ve rsionCl.O.*") ] 

public class HelloWorIdForm : Form 

í 

pub Lie HelloWorIdForm f) 

{ 

Te x t - "Helio, Wi nd ows Fo r ms ! " ; 

1 

} 


public class App1icationEventHandlerClass 
I 

public void OnAppl icationExit (ob j ect sender, EventArgs e i. 

{ 

try 

{ 

Consolé .WnteLme ( "The application is shutting down . " ) ; 

} 

catch(MotSupportedException) 

{ 

} 


public void Onldle(object sender, EventArgs e) 

{ 

Conso1e.WriteLine("The application is idle."); 

} 

public void OnThreadException(object sender, 

Thr eadExceptionEventArgs e) 

{ 
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Console.WnteLme ("ati exception thrown from an applicaticn 
tbread was caught!"); 

} 


public void OnThreadExit(object sender, EventArgs e) 

{ 

Console.WnteLme ("The application' s mam t.hread ís 
shutting down." ) ; 

} 


public class MainClass 
{ 

public static void Main() 
i 

He 11 oWorldForm FormObj ect - new He 1.1 oWor 1 dForm O ; 

ApplicatíonEventHandlerClass AppEvents = new 
ApplíeatíonEventHandleiClass () ; 

Application.ApplicationExit +- new 
EventHandler(AppEvents.OnApplicationExit); 

Application.Idle + ^ new EventHandler(AppEvents.Onldle); 

Application.ThreadException + - new 
ThreadExceptionEventHandler(AppEvents.OnThreadException); 

Application.ThreadExit + ^ new 
EventHand1er (AppEvents.OnThreadExiti ; 

Application.Run(FormObject); 


La nueva clase del listado 21.3 recibe el nombre de Application- 
EventHandlerdass y contiene métodos que controlan los eventos desenca¬ 
denados desde el objeto Appl i catión. El método Main ( ) crea un objeto de 
la clase ApplicationEventHandlerClass y agrega su codigo a la lista 
de controladores de eventos de la clase Application. Los controladores de 
evento de la clase Applicat ÍonEventHandlerClass escriben en la con¬ 
sola. Esto es perfectamente v alido, incluso en una aplicación Windows Forms. 
Si compila el código del listado 2 1.3 usando el destino ejecutable de consola (esc 
/target : exe List ing2 1-3 . es), los mensajes del controlador de eventos 
se escriben en la ventana de la consola que se usó para iniciar la aplicación. Si 
compila el codigo del listado 21.3 usando el destino de ejecutable de Windows 
(esc /target: winexe Li st ing2 l-3.es). ninguna consola esta asocia¬ 
da al proceso y no se muestran mensajes en la consola. 

Propiedades Application 

La clase Application es compatible con varias propiedades que pueden 
usarse en las aplicaciones de C#. Los siguientes apartados describen cómo usar 
cada una de estas propiedades. 
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AllowQuit 

La propiedad booleana AllowQuit especifica si el código puede o no termi¬ 
nar la aplicación mediante programación. La propiedad devuelve True si el códi¬ 
go puede ordenar a la aplicación que termine y False en caso contrario. Esta 
propiedad es de sólo lectura y no se le puede asignar un valor. Por lo general, los 
usuarios pueden terminar las aplicaciones cerrando el formulario principal de la 
aplicación. Algunas aplicaciones se incluyen en contenedores, como clientes Web. 
y no pueden cerrarse mediante programación. Sólo se cierran cuando su contene¬ 
dor se cierra. Si la propiedad AllowQuit devuelve true. se puede llamar a un 
método de Application llamado Exit ( ) para terminar la aplicación me¬ 
diante programación Los métodos del objeto Application se estudiarán en el 
apartado titulado "Métodos Application " 

CommonAppDataRegistry 

La propiedad CommonAppDataRegistry devuelve una referencia a un 
ob|cto de la clase RegistryKey. El objeto RegistryKey hace referencia a 
una clave en el registro que la aplicación puede usar para almacenar datos de 
registro que deberían estar disponibles para todos los usuarios de la aplicación. 
Esta propiedad es de sólo lectura y no se le puede asignar un valor. 

La clase RegistryKey es parte de NET Framcwork y está disponible en un 
espacio de nombre llamado Microsoft. Win32. Representa una clave especí¬ 
fica del registro v contiene métodos que permiten crear subclaves, leer valores y 
realizar otras tareas relacionadas con las claves del registro. 

CommonAppDataPath 

La propiedad de cadena CommonAppDataPath hace referencia a una ruta 
en el sistema de archivos que la aplicación puede usar para almacenar datos 
basados en archivos que deberían estar disponibles para todos los usuarios de la 
aplicación. Esta propiedad es de sólo lectura y no se le puede asignar un valor. 

La ruta de datos de la aplicación se almacena dentro de la ruta de carpeta de 
documentos de Windows para todos los usuarios, que suele encontrarse en 
C:\Documents and Settings\All Users\Datos de programa. 
La ruta real de la aplicación apunta a una carpeta dentro de esta ruta de documen¬ 
tos "all users" que tiene la forma CompanyName\ ProductName\ 
ProductVersion. Los nombres de carpeta CompanyName. ProductName 
y ProductVersion se basan en los valores de las propiedades de la aplicación 
del mismo nombre. Si no se asignan valores a estas propiedades, la clase 
Application proporciona unos valores por defecto válidos. Por ejemplo, el 
código del listado 21.1 tiene una ruta de datos comunes de la aplicación 
C:\Documents and Settings\All Users\Datos de 
pr ograma \S impleHel loWor Id \ S impleHel loWor Id \ VO . 0 . Siel código 
del listado 21.1 va a asignar valores a las propiedades CompanyName. 
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ProductName o ProductVersion de la clase Application, los nom¬ 
bres de carpetas en la ruta de datos comunes de la aplicación puede cambiar para 
reflejar los valores de esas propiedades. 

La ruta de la carpeta de la versión del producto sólo usa los números de 
versión principal y secundario especificados en la aplicación, independientemente 
del numero de valores que asigne en el atributo de la aplicación [Assembly- 
Version] . Si la aplicación usa un atributo [ AssemblyVersion ] con un 
valor, por ejemplo, 1.2.3.4. la parte de número de versión de la ruta de datos 
comunes de la aplicación sera 1.2. La letra V siempre se antepone al número de 
versión principal de la aplicación en la parte de la versión de número de la ruta de 
datos. 

CompanyName 

La propiedad de cadena CompanyName dev uelv e el nombre de la compañía 
asociado a la aplicación. Esta propiedad es de sólo lectura y no se le puede 
asignar un valor. Por defecto, este valor se asigna al nombre de la clase que 
contiene el método Main ( ) de la aplicación. Si la aplicación especifica un nom¬ 
bre de compañía con el atributo [ AssemblyCompany ], el valor de ese atribu¬ 
to se usa como el valor de la propiedad CompanyName de la aplicación. 

CurrentCulture 

La propiedad CurrentCulture permite trabajar con la información de 
referencia cultural de la aplicación. Esta propiedad se puede leer y escribir. La 
propiedad tiene una clase de tipo Culturelnfo. que es una clase definida por 
NET Framevvork y que se encuentra en el espacio de nombres System. 
Globalization. La clase Culturelnfo contiene métodos y propiedades 
que permiten al codigo trabajar con datos específicos del entorno cultural en el 
que se ejecuta la aplicación. Los objetos Culturelnfo ofrecen información 
como el formato preferido para mostrar la fecha y la hora, la configuración de la 
hora y el formato numeral. 

CurrentlnputLanguage 

La propiedad CurrentlnputLanguage permite trabajar con el idioma 
actual de la aplicación. La propiedad tiene una clase de tipo InputLanguage. 
que es una clase definida por NET Framevvork y que se encuentra en el espacio 
de nombres System. Windows . Forms. 

La clase Input Language contiene métodos y propiedades que permiten al 
codigo trabajar con el conocimiento que tenga la aplicación de las teclas del 
teclado y como se relacionan con los caracteres que pueden introducirse en la 
aplicación. Las diferentes versiones específicas de cada lenguaje de Windows 
establecen equiv alencias entre las teclas del teclado y los caracteres específicos 
de los diferentes lenguajes y la clase CurrentlnputLanguage especifica el 
aspecto de esta asignación. 
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ExecutablePath 


La propiedad de cadena ExecutablePath devuelve la ruta del ejecutable 
de la aplicación. Esta propiedad es de sólo lectura y no se le puede asignar un 
valor. 

LocalUserAppDataPath 

La propiedad de cadena LocalUserAppDataPath hace referencia a una 
ruta en el sistema de archivos que la aplicación puede usar para almacenar datos 
basados en archivos que deberían estar disponibles para el usuario conectado en 
ese momento al equipo. 

Esta propiedad es de sólo lectura y no se le puede asignar un valor. Es usada 
por los usuarios locales con perfiles de sistema operativo del equipo local Los 
usuarios con perfiles móviles usados a través de un sistema de redes tienen una 
propiedad distinta, llamada UserAppDataPath. para especificar dónde deben 
almacenarse los datos de la aplicación. 

AI igual que la propiedad CommonAppDataPath. la ruta de datos de usua¬ 
rio local señala a una carpeta incluida dentro de la carpeta de documentos de 
usuario conectada con una estructura de carpetas que tiene la forma 
CompanyName\ ProductName\ ProductVersion. Los nombres de 
carpeta CompanyName. ProductName y ProductVersion se basan en 
los valores de la aplicación del mismo nombre. Si no se asigna un valor a estas 
propiedades, la clase Application proporciona unos valores validos por de¬ 
fecto. Si el codigo asigna un valor a las propiedades CompanyName. 
ProductName o ProductVersion de la clase Application, los nom¬ 
bres de carpetas en la ruta de datos de la aplicación de usuario local cambia para 
reflejar los valores de esas propiedades. 

Al igual que la ruta de datos comunes de la aplicación, la ruta de carpeta de 
versión de producto solo usa los números de versión principal y secundario espe¬ 
cificados en la aplicación, independientemente del numero de valores especifica¬ 
dos en el atributo de la aplicación [ AssemblyVersion] . Si la aplicación usa 
un atributo [ Assemb lyVersion ] con un valor, por ejemplo. 1.2. 3. 4. la 
parte correspondiente al numero de versión de la ruta de datos de usuario local de 
la aplicación sera 1.2. La letra V siempre se antepone al número de versión 
principal de la aplicación en la parte de la versión de número de la ruta de datos. 

MessageLoop 

La propiedad booleana MessageLoop devuelve True si existe un bucle de 
mensajes para la aplicación y Falseen caso contrario. Esta propiedad es de solo 
lectura v no se le puede asignar un valor. Como todas las aplicaciones 
WindowsEorms necesitan un bucle de mensajes para que los mensajes de 
Windows puedan ser enviados al formulario correcto, las aplicaciones 
WindowsForms devuelven True para esta propiedad. 
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ProductName 

La propiedad de cadena ProductName devuelve el nombre del producto 
asociado a la aplicación. Esta propiedad es de sólo lectura y no se le puede 
asignar un valor. Por defecto, a este valor se le asigna el nombre de la clase que 
contiene el método Main ( ) de la aplicación. Si la aplicación especifica un nom¬ 
bre de producto con el atributo [ AssembiyProduct ] . el valor de ese atributo 
se usa como el valor de la propiedad de la aplicación ProductName. 

ProductVersion 

La propiedad de cadena ProductVersion devuelve el numero de versión 
asociado a la aplicación. Esta propiedad es de sólo lectura y no se le puede 
asignar un valor. Por defecto, este valor es 0.0.0.0. Si la aplicación especifica 
un numero de versión con el atributo [AssemblyVersi onf* el valor de ese 
atributo se usa como el valor de la propiedad de la aplicación ProductVersion. 

SafeTopLevelCaptionFormat 

La propiedad de cadena SafeTopLevelCapt i onFormat hace referencia 
a la cadena de formato que el tiempo de ejecución aplica a los títulos de la ventana 
de nivel superior cuando las aplicaciones se ejecutan desde un contexto no seguro. 

La segundad es una parte integral de .NET Frainevvork y el entorno común de 
ejecución (CLR). El CLR respeta la configuración de las diferentes zonas de 
seguridad en Internet Explorer (Internet. Intranet local. Sitios de confianza y 
Sitios restringidos) y restringe los serv icios de tiempo de ejecución para las apli¬ 
caciones que se ejecutan en zonas no fiables. Las aplicaciones WindowsForms 
que se ejecutan desde zonas no fiables, como la zona Internet, tienen una etiqueta 
de aviso que describe la aplicación como procedente de una localización no fia¬ 
ble. El texto de esta etiqueta de aviso esta basado en la plantilla de formato de 
cadena almacenada en la propiedad SafeTopLevelCaptionFormat. 

StartupPath 

La propiedad de cadena StartupPath devuelve la ruta al archivo ejecuta¬ 
ble que inició la aplicación. Esta propiedad sólo devuelve la ruta. No incline el 
nombre del archivo ejecutable. Esta propiedad es de sólo lectura y no se le puede 
asignar un valor. 

UserAppDataPath 

La propiedad de cadena UserAppDataPath hace referencia a una ruta en 
el sistema de archiv os que puede usar la aplicación para almacenar datos basados 
en archivos que deberían estar disponibles para el usuario de red que esta conec¬ 
tado en ese momento al equipo local. Esta propiedad es de sólo lectura y no se le 
puede asignar un valor. Es usada por los usuarios locales con perfiles de sistema 
operativo en la red. Los usuarios que tengan perfiles de equipo local no utilizados 
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en la red usan una propiedad distinta, llamada LocalUserAppDataPath. para 
especificar dónde deben almacenarse los datos de la aplicación. 

Al igual que la propiedad CommonAppDataPath. la ruta de datos de usua¬ 
rio local señala a una carpeta incluida dentro de la carpeta de documentos de 
usuario conectado con una estructura de carpetas que tiene la forma 
CompanyName\ ProductName\ ProductVersion. Los nombres de 
carpeta CompanyName. ProductName y ProductVers ion se basan en 
los valores de la aplicación del mismo nombre. Si no se asigna un valor a estas 
propiedades, la clase Application proporciona unos valores válidos por de¬ 
fecto. Si el codigo asigna un valor a las propiedades CompanyName. 
ProductName o ProductVers ion de la clase Application, los nom¬ 
bres de carpetas en la ruta de datos de la aplicación de usuario local cambia para 
reflejar los valores de esas propiedades. 

UserAppDataRegistry 

El método UserAppDataRegistry devuelve una referencia a un objeto de 
clase RegistryKey. Al igual que la propiedad Common App Data Regis try. 

la propiedad devuelve un objeto de tipo RegistryKey. El objeto RegistryKey 
devuelto hace referencia a una clave en el registro que la aplicación puede usar 
para almacenar datos de registro que sólo deberían estar disponibles para el usua¬ 
rio actual de la aplicación. Esta propiedad es de sólo lectura v no se le puede 
asignar un valor. 

Métodos Application 

La clase Application admite ocho métodos que pueden ser llamados desde 
las aplicaciones de C#. Estos métodos se describen en las siguientes secciones. 

AddMessageFilter 

El método AddMessageFilter ( ) añade un filtro de mensajes a la aplica¬ 
ción para controlar los mensajes de Windows mientras los mensajes son enviados 
a sus destinos. El filtro de mensajes que se instala en la aplicación recibe los 
mensajes de Windows antes de que se envíen al formulario. Un filtro de mensajes 
instalado por AddMessageFilter ( ) puede controlar un mensaje que se le 
envíe y puede decidir si el mensaje debe enviarse al formulario. 

El listado 2 1.4 muestra cómo se puede usar el filtro de mensajes en una aplica¬ 
ción WindowsForms. El controlador de mensajes busca mensajes que anunciar 
cuando se hace clic con el botón izquierdo en el formulario. 

Listado 21.4. Cómo instalar un filtro de mensajes 


using System; 

using System.Windows.Forms; 
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public class BlockLeftMouseButtonMessageFi1ter : IMessageFi1ter 

{ 

const int WM__LBUTTONDOWN = 0x201; 
const int WM_LBUTTONUP = 0x202; 

public bool PreFilterMessage(ref Message m) 

{ 

if(m.Msg == WM_LBUTTONDOWN) 

{ 

Consolé.WriteLine{"The left mouse button ís down."); 
return true; 

} 

íf(m.Msg == WM_LBUTTONUP) 

{ 

Consolé.WriteLine("The left mouse button ís up."); 
return true; 

} 

return false; 

} 


public class MainForm : Form 

{ 

public static void Main() 

{ 

MainForm MyForm = new MainFormO ; 

BlockLeftMouseButtonMessageFilter MsgFilter = new 
BlockLeftMouseButtonMessageFi1ter(); 

Application.AddMessageFilter(MsgFilter); 

Application.Run(MyForm); 

} 


public MainForm() 

{ 

Text - "Message Filter Test"; 


} 

El método AddMessageFilter () recibe un argumento: una implementación 
de una interfaz llamada IMessageFilter. La interfaz IMessageFilter 
es definida por NET Framework y se incluye en el espacio de nombres 

System. Windows . Forms. IMessageFilter declara un método: 

public bool PreFilterMessage(ref Message m) ; 

El método PreFilterMessage ( ) toma como entrada una referencia a 
una instancia de una estructura llamada Message. La estructura Message 
describe un mensaje de Windows y contiene las siguientes propiedades: 

• HWnd. que describe el controlador de la ventana que debe recibir el mensa¬ 
je 
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• LParam. que describe un fragmento de numero entero que se envía con el 
mensaje. 

• Msg. que describe el numero entero ID asociado al mensaje. Cada men¬ 
saje de Windows tiene su propio ID entero. 

• Resuit. que describe el valor que debe devolverse a Windows en res¬ 
puesta al control del mensaje. 

• WParam. que describe otro fragmento de numero entero que se envía con 
el mensaje. 

El listado 214 comienza declarando una clase llamada BlockLeft- 
MouseButtonMessageFiiter. Esta clase implementa la interfaz 
IMessageFi 1 ter . La implemcntación del método PreFilterMes.saqe ( ) 
de la clase comprueba el ID del mensaje pasado al método. Comprueba si el ID 
indica que se ha pulsado el botón izquierdo del ratón. En caso afirmativo, se 
escribe en la consola el mensaje The left mouse button is down. A 
continuación comprueba si el ID indica que se ha soltado el botón izquierdo del 
ratón. En caso afirmativo, se escribe en la consola el mensajeThe left mouse 
button is up. 


NOTA: La clase BlockLef tMouseButtonMessageFilter declara 
constantes para dar nombres a los mensajes de Windows que busca el 
filtro. Los nombres empiezan con WM (por Mensaje de Windows) y coinci¬ 
den con los nombres definidos por Microsoft. Todos los mensajes de 
Windows disponibles y sus valores numéricos están explicados en la docu¬ 
mentación de Platform SDK de Microsoft. 


Las implcmcntacioncs del método PreFilterMcssagc ( ) deben devolver 
un valor booleano que describe si el mensaje debe ser enviado al formulario tras 
pasar por ci filtro o no. Si el filtro considera que el mensaje no debe ser enviado, 
entonces devuelve True. Si el filtro considera que el mensaje debe ser enviado, 
entonces dev uelve el valor Pal se. El filtro de mensajes del listado 2 1 4 dev uelve 
True para los dos mensajes que controla y False para todos los demás mensa¬ 
jes. El método Main() en el listado 214 crea un nuevo objeto de la clase 
BlockLef tMouseButtonMessageFilter y lo usa en una llamada al método 
AddMessageFi 1 ter ( ) del objeto Application. Tras instalar el filtro de 
mensajes, se crea y ejecuta el formulario principal. 

Puede v er el filtro de mensajes en acción compilando el listado 2 1 4. Al ejecu¬ 
tar el codigo. aparecerá el formulario principal de la aplicación. Cuando aparezca 
el formulario, muev a el ratón para que el cursor este dentro del formulario y haga 
clic con el botón izquierdo del ratón. Se escribirá en la consola un mensaje indi¬ 
cando que ha pulsado un boton del ratón. 
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DoEvents 


El método DoEvents ( ) procesa todos los mensajes que se encuentren en la 
cola de mensajes de la aplicación de Windows. El método no recibe argumentos ni 
devuelve ningún valor Este método se invoca cuando se quiere estar seguro de 
que los mensajes en espera de Windows se env ían al formulario mientras se reali¬ 
zan otras tareas. 

Suponga, por ejemplo, que crea un formulario que realiza un calculo largo. Si 
se mueve otra ventana delante del formulario mientras se realiza el calculo. 
Windows envía a la aplicación un mensaje de Windows que indica que el formu¬ 
lario debe ser dibujado de nuevo. Sin embargo, como el codigo esta realizando un 
enorme calculo, el mensaje de nuevo dibujo estara en la cola de mensajes de la 
aplicación; después de todo, el codigo esta ocupado realizando cálculos y no 
procesando mensajes. Se pueden hacer llamadas al método DoEvents ( ) en 
ciertos puntos del proceso para asegurarnos de que los mensajes de espera de 
Windows se procesan mientras el codigo esta ocupado realizando otro trabajo. 

Exit 

El método Exit ( ) obliga a la aplicación a terminar. El método informa a la 
cola de mensajes de la aplicación que debe finalizar y cierra los formularios cuando 
se procesa el ultimo mensaje de la cola de mensajes de Windows. 

Por lo general, el código no necesita inv ocar al método Ex i t ( ) Eos formula¬ 
rios de Windows incluven por defecto un cuadro de cierre en la esquina superior 
derecha del formulario y al hacer clic en ese cuadro se env ía un mensaje de cierre 
a la cola de mensajes de Windows. Sin embargo, puede ser útil llamar a Ex it ( ) 
si el formulario incline un control, como un botón o un elemento de menú que 
debe finalizar la aplicación al ser seleccionado. 

ExitThread 

El método ExitThread ( ) sale del bucle de mensajes y cierra todos los 
formularios en el subproceso en curso. El método no recibe argumentos ni devuel¬ 
ve ningún valor. Si la aplicación WindowsEorms contiene un solo subproceso 
(como es habitual), entonces la acción de llamar a ExitThread ( ) es igual que 
a llamar a Ex i t ( ) . Sin embargo, si la aplicación usa v arios subprocesos, enton¬ 
ces los dos métodos se comportan de forma diferente El método Ex i tThread ( ) 
cierra un subproceso pero permite que los otros subprocesos sigan ejecutándose. 
Sin embargo, el método Exit ( ) . cierra todos los subprocesos a la vez. C orno 
todos los procesos de Windows, las aplicaciones W i ndowsForms siguen ejecu¬ 
tándose hasta que finaliza el último subproceso. 

OleRequired 

El método OieRequired ( ) inicial iza OLE en el subproceso en curso de la 
aplicación. Si la aplicación va a trabajar con tecnología COM. como C OM. DC ONE 
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ActiveX o OLE. se debe llamar a este método de la aplicación antes de usar 
COM 

El método no recibe argumentos, pero devuelve un valor desde una enumera¬ 
ción llamada Apartment State que describe el tipo de apartamento que intro¬ 
dujo el subproceso. La enumeración ApartmentState está definida en un 
espacio de nombre NET Framework llamado System. Threading y puede 
tener uno de los siguientes valores: 

• STA. se devuelve cuando el CLR decide inicializar COM para el subproceso 
entrando en un apartamento de un único subproceso. 

• MTA. se devuelve cuando el CLR decide inicializar COM para el 
subproceso entrando en un apartamento de multiproceso. 

OnThreadException 

El método OnThreadException ( ) desencadena un evento Thread- 
Exception. El evento puede ser capturado por un controlador de exentos 
OnThreadException ( ) instalado en el objeto Application. 

El listado 21.5 muestra cómo puede usarse una excepción de subproceso en 
una aplicación WindowsForms. 

Listado 21.5. Cómo trabajar con excepciones de subprocesos 

using System; 

usmg System.Threading; 

using System.Windows.Forms; 

public class BlockLeftMouseButtonMessageFilter : IMessageFilter 

{ 

const int WM LBUTTONDOWN = 0x201; 

public bool PreFiIterMessage(ref Message m) 

{ 

lf(m.Msg == WM_LBUTTONDOWN) 

{ 

Exception LeftButt onDownException; 

LeftButtonDownException = new Exception("The left mouse 

button was pressed. ") ; 

Application.OnThreadException(LeftButtonDownException) ; 

return true; 

} 

return f a 1s e; 

} 

) 


public class ApplicatíonEventHandlerClass 
{ 

public void OnThreadException(object sender, 
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ThreadExceptíonEventArgs e) 


{ 

Exception LeftButtonDownException; 
LeftButtonDownException = e.Exception; 

Consolé.WriteLine(LeftButtonDownException.Message); 


} 

public class MainForm : Form 
{ 

public static void Main() 

{ 

ApplicationEventHandlerClass AppEvents = new 
ApplicationEventHandlerClass () ; 

MainForm MyForm # new MainForm(); 

BlockLeftMouseButtonMessageFilter MsgFilter - new 
BlockLeftMouseButtonMessageFilter(); 

Application.AddMessageFi1ter(MsgFilter); 

Application.ThreadException + = new 
ThreadExceptionEventHandler(AppEvents.OnThreadException); 
Application.Run(MyForm); 

} 


public MainForm() 

{ 

Text - "Application Exception Test 

} 


El listado 21.5 es parecido al listado 21.4 va que incluye un controlador de 
mensajes que busca mensajes que informan cuando se pulsa el boton izquierdo del 
ratón en el formulario de la aplicación 

La diferencia es que en el listado 21.5 se inicia una excepción al recibir el 
mensaje left mouse button down. El controlador de mensajes crea un 
nuevo objeto Exception v lo inicia usando el método OnThr ead¬ 
Except ion ( ) del objeto Application. El codigo del listado 2 1.5 también 
incline un controlador de eventos de la aplicación, que se implementa en una 
clase llamada Applicat ionEventHandlerClass. Esta clase controla el 
evento OnThr eadExcept ion £ } y el método principal de la aplicación instala 
el controlador de eventos usando la propiedad ThreadExcept ion del objeto 
Application. 

El controlador de excepciones del subproceso instalado en la clase 
App 1 i c a t i o n E ve n t Ha nd 1 e r C 1 a s s extrae la excepción del objeto 
ThreadExcept ÍonEventArgs del controlador y escribe el mensaje de la 
excepción en la consola. Cuando se ejecuta el código en el listado 21.5. aparece el 
formulario principal de la aplicación Cuando aparezca el formulario, mueva el 
ratón hacia su interior y haga clic con el botón izquierdo del ratón. El controlador 
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de mensajes iniciara una excepción y el controlador de excepciones de la aplica¬ 
ción escribirá mensajes de excepción en la consola de la aplicación. 

RemoveMessageFilter 

El método RemoveMessageFilter { ) elimina un filtro de mensajes insta¬ 
lado por el método AddMessageFilter ( ) . Elimina el filtro de mensajes del 
generador de mensajes de la aplicación. El método RemoveMessageFilter ( ) 
recibe un argumento: una implementación de una interfaz llamada IMessage- 
Filter. Este argumento debe hacer referencia a una clase que implementa 
IMessageFilter y que ya ha sido usada en una llamada a AddMessage- 
Fi 1 ter ( ) . El listado 2 1.6 muestra como funciona este método. 

Listado 21.6. Cómo eliminar un filtro de mensajes instalado 

using System; 

us mg System. Windows . Forms ; 

public class BlockLeftMouseButtonMessageFilter : IMessageFi1ter 

{ 

const int WM_LBUTTONDOWN - 0x201; 

public bool PreFilterMessage(ref Message m) 

{ 

íf(m.Msg «= WM_LBUTTONDOWN) 

{ 

Consolé .WnteLine ( "The left mouse button ís down. ") ; 

Application.RemoveMessageFilter (this) ; 

return true; 

} 

return false; 



public class MamForm : Form 
{ 

public static void Main() 

{ 

MainForm MyForm - new MainForm(); 

BlockLeftMouseButtonMessageFilter MsgFilter = new 
BlockLeftMouseButtonMessageFilter(); 

Applicatión.AddMessageFilter(MsgFilter); 

App1ication.Run(MyForm); 

} 


public; MainForm () 

{ 

Text = "Message Filter Removal Test"; 

} 
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El codigo del listado 21.6 instala un filtro de mensajes que busca el mensaje 
left mouse button down. igual que hacía el listado 2 1.4. La diferencia es 
que la implementación del filtro de mensajes en del listado 2 1.6 elimina el filtro de 
mensajes cuando se recibe el mensaje. 

Observe que. cuando se ejecuta el código del listado 21.6. sólo se escribe un 
mensaje en la consola, independientemente del numero de veces que pulse el boton 
izquierdo del ratón con el puntero sobre el formulario. Esto es debido a que el 
filtro de mensajes es eliminado de la aplicación cuando se recibe el primer mensa¬ 
je v. como se elimina el filtro de mensajes, no se pueden detectar nuevos mensajes. 
Todavía se envían mensajes al formulario, pero el codigo del listado 2 1.6 elimina 
el objeto que detecta por primera vez los mensajes después de que se haya elimi¬ 
nado el objeto de la lista de filtros de ex entos de la aplicación. 


TRUCO: El listado 21.6 usa la palabra clave this como parámetro para 
la llamada al método RemoveMessageFilter ( ) del objeto 
Application. Recuerde que la palabra clave this se emplea para ha¬ 
cer referencia al objeto cuyo código se está ejecutando. Puede pensar en la 
instrucción del listado 21.6 que llama a RemoveMessageFilter () 
como si indicara "elimina la referencia a este filtro de mensajes del objeto 
Application". 


Run 

El método Run ( ) inicia el bucle de mensajes de Windows para una aplica¬ 
ción. Todos los listados de este capítulo han usado el método Run ( ) . que acepta 
como parámetro una referencia a un objeto de formulario. Ya debería estar fami¬ 
liarizado con el funcionamiento del método Run ( ) 


Cómo añadir controles al formulario 


El formulario que las aplicaciones WindowsForms crean por defecto no es 
muv interesante. Tiene una barra de título, un icono por defecto y los botones 
estándar de Windows Minimizar. Maximizar y Cerrar Los formularios que en¬ 
contramos en las aplicaciones reales incluyen controles como botones, cuadros de 
texto, etiquetas v elementos similares. Esta sección explica como añadir controles 
a los formularios de las aplicaciones C#. 

En esta sección, examinaremos cómo se implementan los controles desde NET 
Fíamework. El entorno de desarrollo dispone de compatibilidad de clases NET 
para los controles integrados en el sistema operativo Windows, y los ejemplos de 
esta sección muestran su uso en la creación de aplicaciones Windows Forms 
que usan controles en los formularios de la aplicación 
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Jerarquía de las clases de control 

.NET Framework incluye varias clases en el espacio de nombres 
System. Windows . Forms para encapsular el comportamiento de un control. 
Los elementos de interfaz de usuario, como botones, cuadros de texto, casillas de 
verificación y elementos similares, están representados por una clase de control. 

Todas estas clases se derivan de una clase base llamada Control. La figura 
21.2 muestra la jerarquía de clases de las clases de control. Todos los controles de 
la interfaz de usuario comparten alguna funcionalidad: todos deben ser capaces 
de situarse en su contenedor y gestionar sus colores de primer plano y de fondo. 
Como todos los controles comparten este comportamiento, es lógico encapsularlo 
en una clase base y derivar la funcionalidad específica al control en las clases 
derivadas. Los autores de las clases de control de NET Framework adoptaron 
este enfoque al construir las clases. 

Cómo trabajar con controles en un formulario 

El listado 2 1.7 muestra una aplicación WindowsForm que incluye un botón. 
El botón incluye un mensaje en un cuadro de texto al hacer clic. 

Listado 21.7. Cómo trabajar con un botón en un formulario 

using System; 

us i n g System. Drawing; 

u s i n g System.Windows.Forms; 

public el ass MainForm : Form 
{ 

public stalle voicl Main (J 
{ 

MainForm MyForm = new MainForm (); 

Appiicatión.Run(MyForm); 

} 

public MainForm () 

{ 

Button MyBu11on - new Button() ; 

Text - "Button Test"; 

MyButton. Location - new Pomt (25, 25); 

MyButton.Text - "Click Me"; 

MyButton.C1 1 ck new EventHandler (MyButtonClicked) ; 

Cont r ol s . Acld (MyBut t on ) ; 

} 

public void MyButtonClicked(object sender, EventArgs 
Ar gument s) 
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El listado 21.7 muestra varios conceptos importantes que deben tenerse en 
cuenta cuando se trabaja con controles Windows Forms . Estudie el constructor 
del primer formulario. Crea un nuevo objeto de clase Button y establece su 
posición en el formulario con la propiedad Location del boton. Esta propiedad 
se hereda de la clase Control (lo que significa que la propiedad esta disponible 
para cualquier control derivado de la clase Contro 1) y establece la posición de 
la esquina superior izquierda del boton respecto a su contenedor. En el listado 
21.7. la posición del boton se establece a 25 pixeles a la derecha del borde iz¬ 
quierdo del formulario y a 25 pixeles por debajo de la parte superior del formula¬ 
rio. La posición se establece con una nueva instancia de una estructura llamada 
Point. que esta disponible en el espacio de nombres System. Drawi nq de 
NET Framework: 

My Bu f ton . Locati on - n ew P omt {£ 5 , 2 5) / 


TRUCO: El listado 21.7 usa la propiedad Location para establecer la 
ubicación del control. El uso de esta propiedad para que el programa colo¬ 
que los controles puede suponer demasiado trabajo en formularios compli¬ 
cados con muchos controles. Visual Studio .NET dispone de un diseñador 
de formularios que permite, de forma visual, arrastrar y colocar controles 
en formularios. El diseñador crea a continuación los formularios C# equi¬ 
valentes, liberando al programador de la tarea de tener que codificar toda la 
lógica de posicionamiento por sí mismo. 


El siguiente concepto importante del listado 21.7 está relacionado con el con¬ 
trol de exentos de un control. Las clases de control admiten muchos exentos que 
se desencadenan cuando el usuario intcractúa con el control. Muchos de estos 
ex entos se incluyen en la clase base Contro l . aunque la clase de control especí¬ 
fica controla otros ex entos. El ex ento más ex idente de un boton de control sería un 
exento Click. Los botones de los formularios no son de utilidad a menos que 
puedan responder a una acción de un usuario que haga clic con el botón. 

Los controles de NET Framexxork usan el modelo estándar delegado/exento 
para compatibilizar sus eventos. Los ex entos de control se instalan usando instan¬ 
cias de un delegado llamado EventHandler. Este delegado admite dos argu¬ 
mentos. un objeto que especifica el elemento que enx io el evento y un objeto de 
una clase llamada EvcntArgs que encapsula los argumentos del exento. El 
código del formulario del listado 21.7 incluye un método llamado MyButton- 
C1 i cked que modela el delegado EventHandler. Este método se usa como 
un nuexo controlador de exentos y esta conectado al exento Cl ick del boton: 

MyButt on.C1ick f - new EventHandler (MyButtonG1 i cked) ; 

La clase Form controla el ex ento Click del botón mostrando un cuadro de 
texto. Una clase llamada MessageBo?; admite la x isualización de cuadros de 


464 




mensajes de Windows. La clase MessaqeBo:: contiene un método estático 
llamado Show ( ) que muestra un mensaje en un cuadro de mensaje 

El último concepto importante del listado 21.7 es la instrucción que agrega el 
control a la forma: 

C o n Uols . A ti d (M y B u 11 o n ) ; 

La propiedad Control esta definida en la clase base Contro, (recuerde 
que la clase Forro se deriva de la clase Control ). Es un objeto de una clase 
llamada ControlsCoilect ion \ gestiona una lista de controles secundarios 
que son gestionados por el control actual. El codigo Windows Sor irs debe aña¬ 
dir controles a su colección Controls de los formularios contenedores antes de 
que pueda ser usada realmente. 

Cómo trabajar con recursos 


En Windows, los recursos se definen como datos que forman parte de una 
aplicación pero no afectan a la ejecución del codigo. Estos recursos pueden ser 
iconos, mapas de bits o cadenas. El sistema Wi ndowsForns permite almacenar 
los recursos en un archivo separado durante el desarrollo del programa e incluir¬ 
los en un ensamblado cuando se distribuya la aplicación. 

La principal ventaja de guardar los recursos de la aplicación en un archivo 
separado es que ayuda al desarrollo del programa. Si incrustamos todas las cade¬ 
nas dentro del eodigo CU. por ejemplo, entonces sólo alguien que conozca CU 
sabia donde buscar para cambiar los v alores de cadena. Si la aplicación se escri¬ 
be usando cadenas en ingles y luego es necesario cambiar la aplicación para que 
muestre cadenas en alemán, había que leer todo el codigo fuente \ cambiar todas 
las cadenas. Si guardamos las cadenas en un archiv o de tabla de cadenas aparte, 
podemos aplicar un traductor a ese archivo separado para que traduzca las cade¬ 
nas en ingles a su equivalente en alemán sin cambiar el codigo CU fuente. En el 
codigo de la aplicación, el codigo dirá "lee una cadena de la tabla de cadenas" en 
lugar de teclear la cadena en el codigo de la aplicación. 

Cómo trabajar con recursos de cadena 

Eos recursos de cadena se definen en un archivo de texto separado, que debe 
tener la extensión . El archiv o debe contener un conjunto de pares clave, 

v alor, separados por el signo igual La clav e para cada cadena debe ser un nom¬ 
bre único para la cadena que se va a usar en el codigo CU para hacer referencia a 
ella. El valor de cadena real se escribe tras el signo igual Se pueden colocar 
comentarios en los archivos de tabla de cadenas. Los comentarios comienzan con 
el símbolo de la libra v llegan hasta el final de la linea. El listado 21.8 muestra un 
ejemplo de archivo de tabla de cadenas. El archivo contiene una cadena cuyo 
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nombre de clave es Message y cuno valor es Helio from the string 

table! 

Listado 21.8. Ejemplo de un archivo de texto de una tabla de cadena 


- 

# String Table 

Message - Helio from the string table! 

Los archivos de tabla de cadena deben compilarse para formar un ensamblado 
de modo que las aplicaciones C# puedan leerlos. Esto se hace con una herramien¬ 
ta llamada ResGen. La herramienta ResGen se incluye en el SDK de NET 
Framework Es una aplicación de consola que lee el archivo de texto y produce 
una representación binaria de la tabla con extensión resources. Si la tabla de 
cadena del listado 21.8 se escribe en un archivo de texto llamado List ing21- 
8 . txt. puede compilar la tabla de cadenas usando la siguiente línea de coman¬ 
dos: 

resgen Listing21-8.txt 

Esto produce un archivo llamado Listing21-8 . resources. Tras com¬ 
pilar un archivo resources para la aplicación, se puede compilar en el ensam¬ 
blado usando el argumento /res para el compilador de C#. como muestra la 
siguiente línea de comando: 

esc /res:string.resources /out:test.exe test.es 

Esta línea de comando ordena al compilador de C# que cree un ejecutable 
llamado test.exe a partir del archivo fuente de C# test.es. También le 
ordena incrustar en el ejecutable test.exe los recursos que encuentre en el 
archivo stri ng. resources. Como los recursos están incrustados en el eje¬ 
cutable. solo se necesita enviar el ejecutable cuando se distribuye la aplicación 
El archivo de recursos binarios no es necesario en tiempo de ejecución. 

Una vez que se han incrustado los recursos en la aplicación, se pueden leer 
desde el codigo de C#. El listado 21 9 es una modificación del listado 21.7. en el 
que el mensaje del cuadro de mensajes se lee desde un recurso de cadena. 

Listado 21.9. Cómo leer desde un recurso de cadena 

using System; 

using System.Drawing; 

using System.Windows.Forms; 

using System.Resources; 

using System.Ref1ection; 

public class MainForm : Form 

{ 

public static void Main O 


466 



MainForm MyForm - new MainForm() ; 


Application.Run(MyForm); 

} 

public MainForm() 

{ 

Button MyButton = new Button(); 

Text = "Button Test"; 

MyButton.Location = new Point(25, 25); 

MyButton.Text - "Click Me"; 

MyButton.Click + = new EventHandler(MyButtonelícked); 
Controls.Add(MyButton); 


public void MyButtonClicked(object sender, EventArgs 
Arguments) 

{ 

ResourceManager FormResources = new 
ResourceManager("StringTable", 

Assembly.GetExecutingAssembly()); 
string Message; 

Mes sage = FormRes our c es . Ge tS t r mg ( "Mes s age ") ; 
MessageBox.Sh ow(Message) ; 

} 

} 


El listado 2 1.9 se compila con un recurso de tabla de cadenas cuyo archivo de 
texto contiene lo siguiente: 

# = = = = = = = = = = = :=,= 

# String Table 

# = = =. = =: = = = = = = ^ 

Message = The button has been clickecl. 

Este archivo de texto recibe el nombre de StringTable . t:-:t y se compila 
formando un archivo de recursos binario llamado St r ingTable . resources 
mediante la siguiente línea de comando: 

resgen StringTable.txt 

Este comando produce un archivo llamado StringTable. rcsources. 
Este recurso se vincula a la aplicación cuando se compila el código CU principal 
mediante la siguiente línea de comando: 

esc /res;StringTable.resources Listing21-9.cs 

Se pueden leer recursos en las aplicaciones de CU usando una clase de NET 
Framevvork llamada ResourceManager. que se incline en un espacio de nom- 
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bres llamado System. Resources. El codigo del listado 21.Ó crea un nuevo 
objeto ResourceManager para gestionar los recursos incrustados en el ejecu¬ 
table. El constructor recibe dos argumentos: 

• El nombre base del archivo de recursos binarios que contiene el recurso 
que se esta abriendo. Se debe especificar este nombre, aunque no se nece¬ 
sita el archivo físico porque el ensamblado agrupa los recursos en bloques 
y da nombre a los bloques usando el nombre base del archivo de recursos 
binarios original 

• Una referencia al ensamblado que contiene los recursos que se están abrien¬ 
do. Este parámetro es una referencia a un objeto de una clase llamada 
Assembly. que se encuentra en el espacio de nombres System. 
Rcf leet.ion. Como los recursos que se están abriendo están incrusta¬ 
dos en el ensamblado que se está ejecutando, si se llama al método estático 
GetExecut i nqAssembly { ) se devolverá una referencia al ensam¬ 
blado actual. 

Tras inicial izar el objeto Resour ceManager. las cadenas se pueden abrir 
desde el administrador mediante un método llamado GetStr i ng ( ) . Este meto- 
do recibe un argumento de cadena: el nombre de clave de la cadena que se recupe¬ 
ra El método devuelve el valor de la cadena nombrada por la clave. 

Cómo trabajar con recursos binarios 

Las tablas de cadenas basadas en texto no son los únicos recursos que se 
pueden incrustar en los ensamblados. También se pueden incrustar recursos 
binarios, como gráficos e iconos. Los recursos binarios están codificados, me¬ 
diante codificación BASE64. en un documento XML con un formato especial. 
Este documento XML tiene la extensión . resx \ es compilado para formar un 
archivo de recurso mediante resgen. A partir de aquí, puede usar los métodos 
de la clase ResourceManager para trabajar con los recursos binarios como si 
fueran recursos de texto. 

Desafortunadamente, el SDK de ,NET Framevvork no incluye una herramienta 
para generar documentos XML con codificación BASE64 a partir de entradas de 
archivo binario. Sin embargo. Visual Studio NET permite incrustar recursos 
binarios en los ensamblados. 

Resumen 

Este capitulo estudia los fundamentos del proceso de desarrollo para la elabo¬ 
ración de aplicaciones WindovvsForms en C#. También se estudian algunas clases 
elementales, como la clase Application, que gestiona la aplicación 
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WindowsForms como un todo y la clase Form. que gestiona un formulario de la 
aplicación. También se hace un repaso a la arquitectura de las clases de control 
WindowsForms y se examinan los atributos de ensamblado que pueden agregar 
información de versión y descriptiva al ensamblado. 

NET Framework contiene un variado conjunto de clases para elaborar aplica¬ 
ciones WindowsForms. El subsistema WindowsForms esta compuesto por varias 
clases; por desgracia, las limitaciones de espacio no permiten una completa des¬ 
cripción de todas ellas en este libro. Puede examinar la documentación de cada 
clase WindowsForms. Use los conceptos de este capitulo para comenzar a 
investigar todas las clases del espacio de nombres WindowsForms. 
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22 


Cómo crear 


aplicaciones 

Web 

con WebForms 


La última decada ha sido testigo del crecimiento sin precedentes de Internet 
como plataforma de negocios. Hoy en día. la mayoría de los modelos de negocios 
están basados en. o al menos incluyen, el concepto de Internet. Por tanto, el 
enfoque ha cambiado de las aplicaciones de escritorio a las aplicaciones Web. 
Este cambio ha subrayado la necesidad de tecnologías que puedan simplificar el 
desarrollo de aplicaciones Web. 

Para crear aplicaciones Web. NET Framework incluye ASP.NET. que es la 
nueva versión de ASP 3.0. Se pueden crear aplicaciones en ASP.NET usando 
Visual Basic NET o Visual C# como lenguaje de programación del servidor. 
Visual C# permite a los programadores desarrollar potentes aplicaciones Web 
Pero lo más importante es que ayuda a los programadores a luchar contra los 
ciclos cada vez más rápidos, porque les permite realizar más operaciones con 
menos líneas de código y con menos errores, lo que reduce considerablemente el 
coste del proyecto. 

Aunque para crear aplicaciones Web ASP.NET sólo se necesita un editor de 
texto, como el bloc de notas, lo más habitual es usar una plataforma de desarro¬ 
llo. como Visual Studio NET. que proporciona un enorme conjunto de herra¬ 
mientas para diseñar páginas Web. En comparación con los primeros lenguajes de 
programación de páginas Web, en los que había que realizar una gran cantidad de 
codificación. Visual Studio NET proporciona de una interfaz WYSIWYG. Esta 
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interfaz permite arrastrar y colocar controles en WcbForms. que luego pueden ser 
programadas en Visual CU. AI programar en Visual Studio NET se puede sepa¬ 
rar el contenido en codigo y en HTML de un WebForm. Esto hace que resulte muv 
sencillo separar la programación lógica de la presentación lógica, lo que nos 
permite concentrarnos en implcmentar la funcionalidad del proyecto, mas que en 
la presentación de datos. 

En este capítulo aprenderemos a crear una aplicación Web ASP.NET median¬ 
te Visual CU. Mientras creamos la aplicación, diseñaremos un WebForm que usa 
controles de servidor, como etiquetas, cuadros de texto, cuadros de listas, 
hipervmetilos y botones. Por ultimo, aprenderemos a controlar los ex entos gene¬ 
rados por los controladores de servidor. 

Fundamentos de las aplicaciones ASP.NET 
Web 


l as aplicaciones Web ASP.NET son aplicaciones que se emplean en servido¬ 
res Web Estas aplicaciones forman uno o mas WcbForms programados en Vi¬ 
sual CU o Visual Basic NET 

En esta sección, estudiaremos las ventajas y desventajas de las aplicaciones 
Web ASP.NET y como crear aplicaciones ASP.NET con Visual CU. También 
estudiaremos las diferencias entre las aplicaciones ASP.NET v ASP 3.0. 

Nuevas características de ASP.NET 

ASP.NET incluye algunas nuevas características que no estaban presentes en 
ASP 3.0. En esta sección se describen brevemente estas características. 

Ejecución en el entorno .NET Framework 

En comparación con los primeros lenguajes de programación Web. las aplica¬ 
ciones en Visual CU (y otros lenguajes Visual Studio .NET) se ejecutan en el 
entorno del marco de trabajo NET. Así. estas aplicaciones son independientes del 
navegador cliente y funcionan de la misma manera en todas las plataformas clien¬ 
te. 

Otra v entaja de usar un tiempo de ejecución diferente para ASP.NET es que 
las aplicaciones ASP 3.0 pueden coexistir con las aplicaciones ASP.NET' Asi. se 
pueden usar sitios Web ASP 3.0 y ASP.NET en el mismo servidor Web 

Presentación de WebForms 

Eos Wchhorras son la base de una aplicación basada en Web. La aplicación 
Web los usa para interactuar con el usuario. Un WebForm puede incluir vanos 
controles de servidor, como cuadros de texto, etiquetas, cuadros de listas, botones 
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de opción, casillas de verificación y botones, los cuales facilitan la interacción del 
usuario con la aplicación 

Un WebForm consta de dos componentes: la interfaz de usuario (IU) y la 
lógica de la aplicación (aplicación). La interfaz de usuario es el componente 
v isual de un WebForm. Se compone de HTML y controles específicos de la apli¬ 
cación Web. La interfaz de usuario es el contenedor del texto y los controles que 
deben aparecer en la página Web. Se especifica en un archivo con la extensión 
. aspz. 

La lógica de programación de una aplicación Web de ASP NEf está en un 
archivo separado que contiene el codigo encargado de controlar las interacciones 
del usuario con el formulario. Este archivo recibe el nombre de archivo de "eodi- 
o 0 oculto ". Cuando se ejecuta un formulario escrito en CU. el archivo de código 
oculto genera dinámicamente el resultado HTML de la pagina. El archivo de 
codigo oculto de CU tiene una extensión . asp. es. 

La ventaja de separar el código del contenido es que el programador no necesi¬ 
ta concentrarse en la lógica que se usa para mostrar el resultado El diseñador 
Web puede controlar esta tarea. 

Integración con Visual Studio .NET 

Visual Studio NET es la herramienta de desarrollo rápido de aplicaciones 
para ASP.NET Visual Studio .NET ofrece una completa integración con ASP.NET 
v permite arrastrar v colocar controladores de serv idor v diseñar WcbForms con 
el aspecto que tendrán cuando un usuario los v ea. Algunas de las otras ventajas de 
crear aplicaciones ASP.NET con Visual Studio NE I se resumen en la siguiente 
lista: 

• Visual Studio NET es una herramienta de desarrollo rápida de aplicacio¬ 
nes (RAD). En lugar de añadir cada control al WebForm mediante progra¬ 
mación. le ayuda a añadir estos controles usando el cuadro de herramientas, 
ahorrándole trabajo de programación. 

• Visual Studio NET admite controles personalizados y compuestos. Se 
pueden crear controles personalizados que encapsulen una funcionalidad 
común cuv o uso puede ser necesario en varias aplicaciones, del mismo 
modo que se usan los controles Web ASP.NET proporcionados por Visual 
Studio NET. 

Presentación de los controles de servidor 

Ademas de los controles HTML que existían en la época de ASP 3.0. ASP NE I 
presenta controles de serv idor que son componentes de una aplicación Web que se 
ejecutan en el serv idor y encapsulan la funcionalidad de la aplicación. 

Los controles HTML hacen referencia a los elementos H TML que se pueden 
usar en los WcbForms. Por lo general, cuando los controles HTML se env ían al 
serv idor a través del navegador, el serv idor considera que los controles HTML 
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son opacos. Es decir, el servidor no los procesa. Sin embargo, al convertir estos 
controles en controles de servidor HTML pueden quedar a la vista del servidor 
para que realice el proceso. Mediante el uso de atributos, como ID y RUNAT. se 
pueden convertir los controles HTML en controles de servidor HTML. Puede 
añadir estos controles a un WebForm usando la ficha HTML del cuadro de herra¬ 
mientas. Por otra parte, los controles de servidor son completamente transparen¬ 
tes para la aplicación y permiten al programador controlar eventos del lado del 
servidor para gestionar la aplicación Web. 

Aparte de los cuadros de texto convencionales, esta categoría de controles 
también incluye los controles de validación. Los controles de validación son con¬ 
troles programables que ayudan a validar las entradas del usuario. Por ejemplo, 
se pueden usar estos controles para validar el valor de un campo o el patrón de 
caracteres introducido por el usuario. Para validar la entrada del usuario, es 
necesario adjuntar estos controles a los controles de la entrada. 

Controles de usuario y compuestos 

Si quiere duplicar un conjunto de controles en varias páginas, puede crear 
controles en cada formulario por separado. Ésta no es una opción muy útil. Sin 
embargo. ASP.NET nos permite realizar esta operación mediante los controles de 
usuario y compuestos. 

Los controles de usuario son WebForms normales que hemos convertido en 
controles eliminando las etiquetas <HTML> y <FORM> del control. Así. represen¬ 
tan una unidad de codigo y presentación que puede importarse a otro WebForm 

Otro conjunto de controles disponibles en ASP.NET es el de los controles 
compuestos. Los controles compuestos son un conjunto de controles que se han 
compilado para formar una biblioteca. Para usar controles compuestos hay que 
incluir una referencia a la biblioteca del mismo modo que se incluyen las referen¬ 
cias a otras bibliotecas. 

Controles más usados en WebForms 

La tarea básica de diseñar una aplicación Web es añadir controles a un 
WebForm Algunos de los controles más usados en un WebForm son Label. 
TextBox. CheckBox. RadioButton. ListBox. DropDownList. 
HyperLink, Table. Button e ImageButton. Las siguientes secciones 
explican brevemente estos controles. 

Control Label 

El control Label se usa para mostrar texto estático en un WebForm. Los 
usuarios no pueden editar el texto de un control Label. Al añadir un control 
Label* el texto Label aparece como su título. Sin embargo, asignando un valor a 
la propiedad Text del control, es posible modificar el título del control. Se puede 
asignar un valor a las propiedades del control Label en tiempo de ejecución en 
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el archivo de código oculto (.es file) Por ejemplo, si se quiere cambiar el texto de 
una etiqueta cuando un usuario pulsa un botón. Para ello, puede utilizar el si¬ 
guiente código: 

Labe 11. Te xt = ” We 1c orne " 

En el anterior código. Labe 11 es el ID del control Label cuya identificación 
quiere cambiar Si quiere que el control Label desaparezca cuando un usuario 
pulse un botón, puede usar el siguiente codigo: 

Label1.Visible=False 

Control TextBox 

El control TextBox se usa para obtener información, como texto, números y 
fechas, de los usuarios de un WebForm. Por defecto, un control TextBox es un 
control de una línea que permite a los usuarios escribir caracteres en una sola 
línea. Sin embargo, también se puede establecer el control TextBox como un 
control multilínca. Un cuadro de texto multilínea muestra varias líneas y permite 
el ajuste de texto. Un control TextBox también puede usarse para aceptar con¬ 
traseñas. Los controles TextBox utilizados para aceptar contraseñas ocultan 
los caracteres escritos por los usuarios, mostrándolos como asteriscos (*). 

Puede establecer la apariencia de un control TextBox mediante sus propie¬ 
dades. como BackColor o ForeCoLor. También puede cambiar la propiedad 
TextMode de un control TextBox para determinar si un control TextBox 
actúa como un cuadro de texto para aceptar una contraseña, una sola línea de 
texto o varias líneas de texto. 

Controles CheckBox y CheckBoxList 

Las casillas de verificación permiten a los usuarios seleccionar una o más 
opciones de un conjunto de opciones dado. Se pueden añadir casillas de verifica¬ 
ción a un WebForm mediante los controles CheckBox o CheckBoxList. El 
control CheckBox representa una sola casilla de verificación, mientras que el 
control CheckBoxList representa una colección de varias casillas de verifica¬ 
ción. Para agregar estos controles al formulario, simplemente tiene que arrastrar¬ 
los hasta él desde el cuadro de herramientas. 

Tras agregar el control CheckBoxList. es necesario añadirle una lista de 
elementos. Para hacerlo, siga estos pasos: 

1. En la ventana Propiedades, haga clic en el boton de puntos suspensivos 
para acceder a la propiedad Items del control CheckBoxList. Se abrira 
el cuadro de diálogo Editor de la colección Listltem. 


NOTA: Si la ventana de Propiedades no está abierta, pulse F4. También 
puede seleccionar Ver>Ventaria Propiedades, en la barra de menú. 
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2. En el cuadro de diálogo Editor de la colección Listltem. haga clic en 
Agregar para crear un nuevo elemento. Se creará un nuevo elemento y sus 
propiedades se mostrarán a la derecha del cuadro de diálogo. 

2. Verifique que el elemento esta seleccionado en la lista Miembros y a 
continuación establezca las propiedades del elemento. Cada elemento es 
un objeto distinto y tiene las siguientes propiedades: 

• Selected: representa un valor booleano que indica si el elemento esta 
seleccionado 

• Text: representa el texto que se muestra para el elemento de la lista. 

• Valué representa el valor asociado al elemento. El valor de un control 
no se muestra ai usuario. Sin embargo, el servidor usa el valor para 
procesar la información del control. Por ejemplo, puede establecer la 
propiedad Text de un elemento como Nombre de Ciudad y la propie¬ 
dad Valué del codigo postal de esa ciudad como identificación única. 
C uando el servidor procesa la información representada por el campo 
Nombre de Ciudad, se puede hacer caso omiso del texto proporcionado 
por el cuadro de texto y cualquier proceso se basara en el correspon¬ 
diente valor del campo. 

4 Especifique el texto que se mostrará al usuario. 

5. Repita los pasos 2-4 para agregar los controles necesarios al control 

CheckBoxL i.s t. 

6 Haga clic en Aceptar para cerrar el cuadro de dialogo Editor de la colec¬ 
ción Listltem. 


TRUCO: La decisión de usar el control CheckBox o el control 
CheckBoxList depende de las necesidades específicas. El control 
CheckBox proporciona más control sobre la presentación de las casillas 
de verificación de la página. Por ejemplo, se puede establecer la fuente y el 
color de las casillas de verificación por separado o incluir texto entre las 
diferentes casillas de verificación. Por otra parte, el control CheckBoxList 
es una mejor opción si se necesitan agregar series de casillas de verifica¬ 
ción. 


Controles RadioButton y RadioButtonList 

Eos botones de opeion proporcionan un conjunto de opciones para el usuario. 
Puede agregar botones de opeion a un WcbForm usando el control RadioButton 
o el control RadioButtonList. El control RadioButton representa a un 
solo botón de opción con el que trabajar. El control RadioButtonList es una 
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colección de botones de opcion Los botones de opción casi nunca se usan indivi¬ 
dualmente. Mas bien se usan dentro de un grupo. 

Un grupo de botones de opción proporciona un conjunto de opciones mutua' 
mente excluventes. Esto significa que sólo se puede seleccionar un botón de op¬ 
ción en un grupo. Un conjunto de botones de opción puede agruparse de estas dos 
maneras: 

• Puede agregar un conjunto de controles Rad i o Bu t ton a la pagina y 
asignarlos a un grupo manualmente. Puede usar la propiedad GroupName 
para hacerlo. 

• Puede agregar un control RadioButtonLi st a la página Los botones 
de opción en el control se agrupan automáticamente, de modo que no es 
necesario agruparlos manualmente 

Tras añadir un control RadioButtonList al WebForm. hay que agregai 
los botones de opcion. Esto se puede hacer usando la propiedad T tenis del mis¬ 
mo modo que hicimos con el control CheckBoxList. 

Control ListBox 

El control ListBox representa una colección de elementos de lista. El con¬ 
trol permite a los usuarios seleccionar uno o mas elementos de la lista. Se pueden 
añadir elementos a la lista individual mediante la propiedad Items. También 
puede especificar si el usuario puede seleccionar varios elementos de la lista o si 
solo puede seleccionar un único elemento, mediante la propiedad Se i ect lon- 
Mode del control ListBox. 

Control DropDownList 

El control DropDownList permite a los usuarios seleccionar un elemento 
de un conjunto de elementos predefinidos (siendo cada elemento un objeto dife¬ 
rente con sus propias propiedades). 

Se pueden agregar elementos a un control DropDownLi st mediante su pro¬ 
piedad Items. A diferencia del control ListBox. solo se puede seleccionar un 
elemento cada vez y la lista de elementos permanece oculta hasta que el usuario 
hace clic en el botón desplegable. 

Control HyperLink 

El control HyperLink permite a los usuarios moverse de un WebForm a otio 
dentro de una aplicación. También permite a los usuarios desplazarse hasta una 
URL que puede estar asociada con el control 

Con el control HyperLink. el texto o una imagen pueden funcionar como un 
hiper\ incido. Cuando un usuario hace clic en el control, se abre el WebForm de 
destino o la URL 
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El siguiente fragmento de código muestra cómo establecer la propiedad 

NavigateUrl: 

Hyperlinkl.NavigateUrl="http://www.amazon.com"; 

Controles Table, TableRow y TableCell 

Las tablas se usan para mostrar información en formato tabular. Se puede 
agregar una tabla a un WebForm mediante el control Table. Este control puede 
mostrar estáticamente información estableciendo las filas y columnas durante su 
creación Sin embargo, se puede programar el control Table para mostrar infor¬ 
mación dinámicamente en tiempo de ejecución. 

Otros dos controles relacionados con las tablas que se pueden emplear en un 
WebForm son TableRow y TableCell. El control TableRow se usa para 
declarar una fila y el control TableCell para declarar una celda en una tabla. 

Para comprender como se relacionan entre sí los controles Table. TableRow 
y TableCell. agregue un control Table a su WebForm (arrástrelo desde el 
explorador de soluciones) y realice los siguientes pasos para agregar filas y cel¬ 
das a la tabla: 

1 En la ventana de Propiedades, haga clic en el botón de puntos suspensivos 
para que aparezca la propiedad Rows del control Table. Se abrirá el 
cuadro de dialogo Editor de colección TableRow. 

2. En el cuadro de diálogo Editor de colección TableRow. que representa 
el control TableRow. haga clic en Agregar para crear una nueva fila. Se 
creará una nueva fila y se mostrarán sus propiedades a la derecha del 
cuadro de diálogo. 

3. Verifique que la fila ha sido seleccionada en la lista de miembros y a 
continuación haga clic en el botón de puntos suspensivos para que la pro¬ 
piedad Cells añada una celda a la fila. El cuadro de diálogo Editor de 
colección TableCell se abrirá. 

4. En el cuadro de dialogo Editor de colección TableCell. que representa 
al control TableCell. haga clic en Agregar para crear una nueva celda 
Se creara una nueva celda y se mostrarán sus propiedades en el lado dere¬ 
cho del cuadro de diálogo. 

5. Especifique el texto que debe mostrarse en la celda y haga clic en Aceptar 
para cerrar el cuadro de dialogo Editor de colección TableCell. 

6. Haga clic en Aceptar para cerrar el cuadro de diálogo Editor de colec¬ 
ción TableRow. 

Observe que después de realizar estos pasos, se ha añadido una tabla 1 x 1 al 
formulario. La tabla 22.1 describe algunas de las propiedades de los controles 

Table. TableRow v TableCell. 
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Tabla 22.1. Propiedades de los controles Table, TableRow y TableCell 


Propiedad 

Disponible con 

Descripción 

ID 

Table 

Representa el ID único del control. 

Rows 

Table 

Representa una colección de obje¬ 
tos TableRow. Un control TableRow 
representa una fila de la tabla. 

Cells 

TableRow 

Representa una colección de obje¬ 
tos TableCell. Un control Table¬ 
Cell representa una celda de la 
tabla. 

VerticalAlign 

TableCell 

Representa el alineamiento vertical, 
como las partes superior e inferior 
de la celda. 

HorizontalAlign 

TableCell 

Representa el alineamiento horizon¬ 
tal, como los alineamientos derecho 
e Izquierdo, de la celda. 


Control ImageButton 

El control ImageButton permite a los programadores mostrar imágenes en 
un WebForm y gestionarlas durante el diseño o en tiempo de ejecución. Este 
control representa un botón gráfico, que mejora la apariencia del WebForm. Se 
puede establecer la propiedad ImageUrl para que apunte a una imagen especí¬ 
fica. 

Controles Button y LinkButton 

El control Button de un WebForm se usa para enviar la pagina al servidor. 
Se pueden agregar tres tipos de botones de control de servidor a un WebForm: 

• Button: Representa un botón estándar. 

• LinkButton: Representa un botón que hace que la página se envíe al 
serv idor. Además, también puede funcionar como hiperv ínculo a otra pa¬ 
gina Web o WebForm. 

• ImageButton: Este control se estudio en el anterior apartado. 

Cómo crear y configurar una aplicación Web 

Visual C# proporciona la plantilla de aplicación Web ASP.NET para crear 
aplicaciones Web ASP.NET. Esta plantilla contiene la información necesaria para 


479 





crear, procesar y emplear aplicaciones ASP. Antes de crear un provecto de apli¬ 
cación Web necesitará asegurarse de que se cumplen en la plataforma de desarro¬ 
llo los siguientes requisitos básicos para la aplicación Web: 

• Deberá tener acceso a un equipo que ejecute Microsoft 11S Server. 

• Debe instalar 11S Server en una partición NTFS. Este tipo de partición 
mejora la seguridad y rendimiento del servidor. 

I ras cumplir estos requisitos, puede usar Visual Studio NET para crear una 
aplicación Web ASP.NET. 

Para ello, siga los siguientes pasos: 

I Agregue un provecto de aplicación Web ASP.NET a su aplicación 

2. Cree la interfaz de usuario de la aplicación Web. 

3. Codifique la lógica de la aplicación 

En la siguiente sección se indican los pasos para crear un nuevo provecto. 

Cómo crear un nuevo proyecto 

Esc la plantilla de aplicación Web ASP NET para crear provectos de aplica¬ 
ciones Web Los pasos para crear una nueva aplicación Web usando esta plantilla 
son los siguientes: 

1. Seleccione Archivo >Nuevo Proyecto para abrir el cuadro de dialogo 
Nuevo Proyecto, como aparece en la figura 22.1. 
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Proyecto para crear una aplicación con una interfaz de usuario de Windows. 


Nombre ; [window s Application i; 

Ubicación: | ebiapplic-atiuris Examinar... 


El proyecto se creará en e:\applications\WindowsApplication3. 


¥Más Aceptar I Cancelar Ayuda 


Figura 22.1. Puede seleccionar una o más plantillas de empresa del cuadro 
de diálogo Nuevo proyecto. 
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TRUCO: También puede pulsar la combinación Control-Mayús-N para 

abrir el cuadro de diálogo Nuevo proyecto. 

2. Seleccione Proyectos de Visual C# de la lista Tipos de proyecto. 

3. Seleccione Aplicación Web ASP.NET de la lista Plantillas en el cuadro 
de diálogo Nuevo proyecto 

4 Escriba el nombre del provecto en el cuadro Nombre 

5. Escriba el nombre de 1IS Server en el cuadro Ubicación o acepte la ubica¬ 
ción por defecto. El cuadro de diálogo Nuevo proyecto puede verse com¬ 
pleto en la figura 22.2. 


Nuevo proyecto 
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Proyecto para crear una aplicación con una Interfaz de usuario Web. 


Nombre: ]■ 

Ubicación: J http: //locaihost/'Web Application 1 Examinar.., 


E! proyecto se creará en http;//localhost/WebApplicationl, 


TMás 


Aceptar 


Cancelar 


Ayuda 


Figura 22.2. Seleccione una plantilla y especifique el nombre de la aplicación en el 
cuadro de diálogo Nuevo proyecto. 


TRUCO: Si el servidor Web está instalado en su equipo, también puede 
escribir http://locaihost in en el cuadro Ubicación. 


6. Haga clic en Aceptar. Aparecerá un cuadro de diálogo mientras Visual 
Studio NET crea la nueva aplicación Web ASP.NET. El cuadro de diálo¬ 
go se muestra en la figura 22.3. 


NOTA: Quizás tenga que esperar unos instantes a que ASP.NET cree el 
proyecto. También debe asegurarse, antes de crear la aplicación, de que el 
servidor Web está funcionando. Para activar el servidor Web, seleccione 
lnicio>Ejecutar. En el cuadro de diálogo Ejecutar, escriba net start 
iisadmin y pulse Intro. 


481 








Creando el Web 'htípi/Zlocalhost/WebApplicationl'. 


1 ^ 



Figura 22.3. Visual Studio NET crea el nuevo proyecto. 

Tras crear un nuevo proyecto de aplicación Web, el asistente para aplicación 
Web crea automáticamente algunos archivos de provecto necesarios, como 

Assemblylnf o .es. Web.config y Global .asax. junto al archivo prin¬ 
cipal de la pagina. WebForml. aspx. La figura 22.4 muestra estos archivos en 
el explorador de soluciones. 



Figura 22.4. La ventana de proyecto muestra todos los archivos creados por el 
asistente de la aplicación Web. 

Un WebForm de Visual Studio NET tiene dos vistas: Diseño y HTML. 

• Vista Diseño. La interfaz de usuario de un WebForm se diseña en vista 
Diseño. Esta vista ofrece dos diseños para el WebForm: diseño de cuadrí¬ 
cula y diseño de flujo: 

• Diseño de cuadrícula. En el diseño de cuadrícula, se pueden colocar 
los controles en el WebForm según las coordenadas de cada control. 

• Diseño de flujo. En el diseño de flujo, se puede diseñar de forma linear 
un WebForm. del mismo modo que se diseña un documento de Microsoft 
Word, de arriba abajo. 

Puede alternar entre los diferentes diseños haciendo clic con el botón dere¬ 
cho en el WebForm y seleccionando Propiedades. En la página Propie¬ 
dades puede seleccionar el diseño que considere apropiado. 

• Vista HTML. Esta vista representa la correspondiente sintaxis ASP.NET 
del WebForm. Para abrir la vista HTML, sólo tiene que hacer clic en la 




ficha HTML. Si la ficha HTML no está visible, puede hacer clic con el 
botón derecho del ratón y seleccionar Ver fuente HTML en el menú abre¬ 
viado. 


Cómo agregar controles al WebForm 

Se pueden agregar controles a un WebForm de dos maneras: 

• Mediante el cuadro de herramientas. Puede agregar controles en la vista 
Diseño del WebForm (el archivo aspx) usando el cuadro de herramientas 
incluido en Visual Studio .NET. Dentro del cuadro de herramientas hay 
varios tipos de controles clasificados dentro diferentes fichas, como 
WebForms. HTML y Datos. Por ejemplo, puede usar la ficha HTML para 
crear controles de servidor HTML y la ficha WebForms para crear los 
controles de servidor ASP.NET. Todos los controles estudiados hasta aho¬ 
ra pertenecen a la ficha Windows Forms del cuadro de herramientas. Cuando 
se usa el cuadro de herramientas para agregar controles Web en vista 
Diseño, se genera automáticamente la sintaxis C# correspondiente. 


TRUCO: Al usar controles HTML debe convertirlos a controles de servi¬ 
dor con el fin de que estén disponibles para ser codificados en el servidor. 
Para ello, haga clic con el botón derecho en el control HTML requerido y 
seleccione la opción Ejecutar como control del servidor en el menú 
abreviado. Este método permite crear complicados WebForms cómoda y 
rápidamente. 


• Usar sintaxis de Visual C# para agregar los controles mediante pro¬ 
gramación También puede agregar controles Web a un WebForm me¬ 
diante la sintaxis de Visual C#. Sólo se puede usar la sintaxis de C# en la 
vista HTML de la página (archivo aspx). La sintaxis real depende del tipo 
de control que quiera añadir. Por ejemplo, la sintaxis que se usa para 
agregar un control de cuadro de texto HTML es la siguiente: 

Cmput id=Textl Type-text runat = "server"> 


NOTA: Visual Studio .NET permite agregar controles de servidor ASP.NET 
mediante una etiqueta de lenguaje extensible para el análisis de documentos 
(XML). La sintaxis usada para agregar un cuadro de texto ASP.NET es: 

<asp:TextBox id=TextBoxl runat^"seryer”></asp:TextBox> 


Cada control tiene una propiedad ID que se usa para identificar unívocamente 
al control. 
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Para establecer la propiedad de un control en tiempo de ejecución se usa la 
siguiente sintaxis: 

Control ID.Property=Value 

En la anterior sintaxis: 

• Control ID representa la propiedad ID del control. 

• Property representa la propiedad del control. 

• Valué representa el valor asignado a la propiedad del control. 

La figura 22.5 muestra un WebForm que contiene los habituales controles Web 
como etiquetas, cuadros de texto, hipervínculos. botones de opción, casillas de 
verificación y botones. Como puede ver. el WebForm es un formulario de registro 
de usuario. El formulario está diseñado para aceptar entradas de usuario desde 
varios controles. Tras rellenar el formulario, el usuario puede hacer clic en el botón 
Submit (Enviar) para completar el registro. El boton Submit abre otro WebForm 
que muestra un mensaje junto al nombre que el usuario introdujo en el control 
TeztBox. Si el usuario hace clic en el botón Reset (Restablecer), la información 
que ha introducido el usuario se elimina de los controles de ese formulario. 


3 WebForm 1 * Microsoft Internet Explorer 


x] 
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Submit | Reset | 



¿Justo 

"M | ' ^Intranet (ocal 



Figura 22.5. El formulario de registro de usuario muestra los controles comunes que 
se pueden agregar a un WebForm. 

Para crear el formulario mostrado en la figura 22.5. realice los siguientes 
pasos: 
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1. Seleccione el formulario WebForm 1 aspx y pulse F4 para que aparezca la 
ventana Propiedades. 

2. En la ventana Propiedades, pulse el botón de puntos suspensivos para 
que aparezca la propiedad bgColor y seleccione Propiedades. Se abri¬ 
rá el cuadro de diálogo Selector de colores. 

3. En el cuadro de diálogo Selector de colores, seleccione un matiz rosa y 
haga clic en Aceptar. El color del WebForm cambiará al color que ha 
especificado. 

4 Agregue controles al formulario y cambie sus propiedades, como recoge la 
tabla 22.2. 

Tabla 22.2. Controles que se pueden agregar a un WebForm 


Control 

Propiedad 

Posición 

Label 

Text=Registration Form 

Font 

Bold=True 

Size=Larger 

Para situarlo en la par¬ 
te superior, inferior o en 
el centro del formulario 

Etiquetas para 

El texto de cada etiqueta debe 

Una bajo otra en el lado 

Nombre, Correo 

ser la misma que el título de- 

izquierdo de la pantalla 

electrónico, Esta¬ 
do y Suscripción 

seado. 


TextBox 

ID=txtName 

Junto a la etiqueta 

Ñame 

TextBox 

ID=txtEmai1 

Junto a la etiqueta E- 
Mail 

DropDownLis t 

ID=1s tState 

Junto a la etiqueta 


11ems=Ari zona, 
California, Florida 

State 

CheckBoxLis t 

ID=lstOptions 

Junto a la etiqueta 


Items=Books, Magazines 

Suscription 

Button 

ID=BtnSubmit 

Text=Reset 

Bajo la etiqueta 
Suscription 

Button 

ID=BtnReset 

Text=Reset 

Junto al botón Submit 
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La interfaz de su WebForm. como aparece en la figura 22.6. está lista. 

Agregará la funcionalidad de los botones Submit y Reset en la siguiente sec¬ 
ción Sin embargo, antes de continuar, agregue a la aplicación Web otro formula¬ 
rio que muestre los detalles sobre el usuario registrado cuando éste haga clic en el 
botón Submit. Para agregar el WebForm. siga estos pasos: 

I . Seleccione Proyecto>Agregar WebForm. Se abrirá el cuadro de dialo¬ 
go Agregar nuevo elemento. 


TRUCO: Si no encuentra la opción de menú Agregar WebForm bajo el 
menú Proyecto, haga clic en cualquier parte de la ventana Formulario y a 
continuación seleccione la opción de menú. 


UserRegApp - Microsoft Visual C# .NéT [diseñar] - WebFormlJMpK* 


| Archivo Edición Ver Proyecto generar depurar Datos Formato labia Insertar Mateos Herramientas Ventana Ayuda 

Jl' ¡¿í B 0 © * l - r » ► Debug - & registrar - [?? ? 

Ill^ ^ O ü , H *| 

t.it li' r- vmr -A.' WebForm I.aspH* j • vn- v .'•■•-f ¡¡ fv i ó: i-r . J 1 ' * 


Üegistration Form 


frame 
; Í-Maü ; | 

• ¡btate • • 
l>uscnption 


Mf” [Books]:: ■ 

; r [Magazines j: 


| a Lisen.-I | □ HTML 
I Listo 


n: 
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Figura 22.6. El WebForm deberla tener este aspecto una vez completa 


2. Seleccione WebForm en la lista de Plantillas, especifique un nombre para 
el WebForm (o mantenga el nombre por defecto) y haga clic en Abrir para 
crear un nuevo WebForm. 

Pude usar el recién agregado WebForm para mostrar un mensaje al usuario. 
Por lo tanto, necesitará agregar un control Label al formulario. Llame a la 
etiqueta lblMessage. 

Tras agregar controles al formulario, debe responder a los eventos generados 
por los controles del formulario para trabajar con la interacción del usuario. Por 
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ejemplo, si un usuario hace clic en el botón Submit. el formulario necesitará ser 
procesado y los datos de la base de datos tendrán que actualizarse. 

La siguiente sección describe el procedimiento para controlar los eventos ge¬ 
nerados por los controles de un WebForm. 

Cómo controlar eventos 

Cuando los usuarios interactúan con los diferentes controles Web de una pági¬ 
na. se desencadenan eventos. Un evento es una acción que puede tener lugar sobre 
un objeto o sobre un control, que pueden ser generados por una acción de un 
usuario o por el sistema. Por ejemplo, cuando pulsa un boton del ratón o una 
tecla, se genera un evento. 

En los formularios de cliente tradicionales o en las aplicaciones Web basadas 
en clientes, los eventos se desencadenan y gestionan por parte del cliente. En las 
aplicaciones Web. los eventos se desencadenan en el cliente o en el servidor. Sin 
embargo, los eventos generados siempre son controlados en el servidor. Los con¬ 
troles de servidor ASP.NET sólo admiten eventos de servidor, mientras que los 
controles de servidor admiten eventos de serv idor y de cliente. 

Viajes de ida y vuelta 

Los WebForms son procesados en el servidor Por ejemplo, imagine un formu¬ 
lario de registro de usuario. Cuando un nuevo usuario especifica un valor para el 
nombre de registro, el servidor debe asegurarse de que el nombre de registro 
proporcionado por el usuario es único. Puede asegurarse de que el nombre de 
registro es único interceptando el evento Click de un botón y comparando el 
nombre de usuario con una fuente de datos. 

Cada vez que una interacción de usuario requiere ser procesada por el servi¬ 
dor. el WebForm es enviado al servidor y procesado, entonces el resultado es 
devuelto al cliente por medio de un navegador. Esta secuencia de procesamiento 
de información en el servidor recibe el nombre de proceso de ida y vuelta . como 
muestra la figura 22.7. 

Casi todas las interacciones con los controles del servidor dan como resultado 
viajes de ida y vuelta. Como un viaje de ida y vuelta implica enviar el WebForm 
al servidor y luego mostrar el formulario procesado en el navegador, el control del 
serv idor afecta al tiempo de respuesta en el WebForm. Por tanto, el número de 
eventos disponibles en los controles de serv idor de un WebForm deben ser los 
menos posibles. Por lo general, esto se reduce a los eventos Click. 


NOTA: Los eventos que tienen lugar con bastante frecuencia en lenguajes 
de secuencia de comandos, como OnMouseOver, no son compatibles con 
los controles de servidor. Sin embargo, algunos controles de servidor admi¬ 
ten eventos que tienen lugar cuando cambia el valor del control. 
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Navegador ( aspx) 


Servidor (es) 


Encontrar I Elemento | 


Código de 

| Enviar | 


la aplicación 




Encontrar j Elemento | 
Encontrados 
2 elementos 
| Enviar j 


Formulario procesado 
(para el navegador) 

Figura 22.7. El proceso de ida y vuelta 

La tabla 22.3 describe los eventos más comunes asociados a diferentes con¬ 
troles de servidor ASP.NET. 

Tabla 22.3. Eventos asociados a controles de servidor ASP.NET 


Control(es) 

Evento 

Descripción 

T e x t B o x 

TextChanged 

Tiene lugar cuando el foco 
sale del control. 

RadioButton y 

Chec kBox 

CheckedChanged 

Tiene lugar cuando se 
hace clic en el control. 

RadioButtonList, 
CheckBozList, ListBox 
y DropDownList 

SelectedIndex- 
Changed 

Tiene lugar cuando se 
cambia la selección de la 
lista. 

Button, LinkButton 
y ImageButton 

Click 

Tiene lugar cuando se 
hace clic en el botón. 
Este evento hace que el 
formulario sea enviado al 
servidor. 


Por defecto, en un WebForm. sólo el evento Click de los controles de servi¬ 
dor Button. LinkButton y ImageButton pueden hacer que se envíe el 
formulario al servidor para ser procesado. En ese caso, el WebForm es devuelto 
al servidor. Cuando otros controles generan los eventos de cambio, son atrapados 
v ocultados. No hacen que el formulario se envíe inmediatamente. Solamente 
cuando el formulario es devuelto mediante un clic en un botón, todos los eventos 
ocultos se desencadenan y son procesados. No hay una secuencia particular para 
procesar estos eventos de cambio en el servidor. Sin embargo, el evento Click 
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se procesa solamente después de que todos los otros eventos de cambio hayan 
sido procesados. 

Controladores de eventos 

Cuando se desencadena un evento, éste necesita ser controlado para ser pro¬ 
cesado posteriormente. Los procedimientos que se ejecutan cuando ocurre un 
evento reciben el nombre de controladores de eventos. Los controladores de 
eventos pueden ser creados automática o manualmente. 

Cuando los eventos se controlan automáticamente, al hacer doble clic sobre un 
control en la vista Diseño del WebForm (aspx file) se crea un controlador de 
eventos. Por ejemplo, cuando se hace doble clic sobre el botón, bt nSubmi t. se 
genera el siguiente codigo. A continuación puede escribir el codigo en el controla¬ 
dor de eventos de la función generada por Visual Studio NET 

Public void btnSubmi t _C 1 ick ( Ob j ect sender, System. F.ventArqs e) 

{ 


En el anterior código, el procedimiento btnSubmit_Click es el controla¬ 
dor de eventos del evento Click del botón. El procedimiento toma dos argumen¬ 
tos. El primero contiene el emisor de eventos. Un emisor de eventos es un objeto, 
como un formulario o un control, que puede generar eventos. El segundo argu¬ 
mento contiene información adicional asociada al evento, como las coordenadas 
de posición x ey. en las que se ha pulsado el botón del ratón. 

Para crear manualmente un controlador de eventos, selecciónelo de la lista 
emergente de la ventana Propiedades. 

Ya está preparado para implementar el control de eventos para el WebForm 
que aparece en la figura 22.7. 

Al hacer clic en el botón Submit. aparece una nueva página (en este caso 
WebForm2.asp\). que muestra un mensaje de bienvenida junto al nombre del 
usuario registrado. Para implementar esta funcionalidad debe escribir el siguiente 
código en el evento Click del botón Submit del WebForm WebForm I aspx: 

prívate void BtnSubmit Click (object sender, System.EventArgs e.) 

{ 

Respons e.Redirect("WebForm2.aspx ? s t rName="+ t xtName.Textl ; 

} 


TRUCO: Para codificar el evento del botón Submit, haga doble clic en la 
vista Diseño. 


En el anterior código, el método Redirect de la clase HttpResponse 
redirige al usuario a la página WebForm2.asp\ y pasa el valor del parámetro 
txtName a la página de destino. 
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Tras pasar el valor del cuadro de texto txtName. debe inicializar WebForm2 
para controlar la cadena pasada desde el formulario de registro. Para hacerlo. 
WebForm2.aspx debe tener el siguiente código en el evento Load: 

prívate void Page_Load(object sender, System.EventArgs e) 

{ 

lblMessage.Text="Hi! " + Request.QueryString.Get("strName"); 

} 


TRUCO: Para codificar el evento Load del formulario WebForm2.aspx, 
haga doble clic en el formulario en vista Diseño. 


Fn el anterior código, el título de la etiqueta lblMessage en el archivo 
WebForm2.asp\ es el valor que se asigna al valor almacenado en la variable 

s t rName. 

Cuando el usuario hace clic en el botón Submit de WebForm 1 aspx. es redirigido 
a la pagina WebForm2.asp\. como muestra la figura 22.8. 
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Figura 22.8. Cuando un usuario es redirigido a otra página, el nombre del usuario se 

pasa en la cadena de consulta. 


Cuando el usuario hace clic en el botón Reset. debe generarse un evento que 
elimine todos los controles rellenados por el usuario en WebForm I aspx. Para 
implementar esta funcionalidad, codifique el evento Click del botón Reset como 
se indica a continuación: 
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prívate void BtnReset_Click (object sender, System.EventArgs e) 

{ 

t x t Ñame. T e x t = ""; 
t x t Erna i 1 . T e x t = " " ; 

IstState.ClearSelection(); 

IstOptions.ClearSelection(); 

} 

En el código anterior, cuando se hace clic en el botón Reset del formulario de 
registro, el formulario se reinicia y vuelve a su estado original. 

Cómo controlar la devolución de datos 

Como se menciono antes, sólo se devuelve un WebForm al servidor cuando se 
hace clic en un control Button. LinkButton o ImageButton control. Una 
vez que se ha enviado el formulario al servidor, es procesado allí Puede controlar 
la devolución de datos correspondiente al clic de un boton de una de estas formas: 

• Escribiendo un controlador de exentos para el ex ento Cl ick del botón. 

• Escribiendo el controlador de exentos para el exento Load del WebForm. 
El exento Load se genera cuando se abre el formulario. Puede usar la 
propiedad IsPostBack del exento Load para determinar si la página ha 
sido procesada por primera x ez o si ha sido procesada por un clic de boton. 
El siguiente código muestra el controlador de ex entos para un exento Load 
de un WebForm: 

protected void Page_Load(object sender, EventArgs e) 

{ 

if ( !IsPostBack) 

{ 

//Evalúa true la primera vez que el navegador llega a 
la pagina 
} 

} 


Cómo usar el estado de vista 

En las aplicaciones Web tradicionales, cada xez que se procesa una pagina 
Web en el servidor, la página se crea desde cero. El servidor elimina la informa¬ 
ción de la página actual después de procesarla x envía la pagina al cliente 
(navegador). Como la información de la pagina no está guardada en el servidor, 
las paginas Web se llaman sin estado. Sin embargo, el marco de trabajo ASP.NET 
resuelve esta limitación y puede guardar la información de estado del formulario 
y sus controles. Para gestionar la información de estado. Visual Studio NET 
proporciona las siguientes opciones: 

• Guardar el estado de vista. Puede guardar el estado de \ ista de los con¬ 
troles de un objeto. En cada viaje de ida y vuelta, el estado del control del 
servidor puede cargarse desde el estado guardado de modo que el usuario 
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pueda ver todas las opciones que el usuario haya seleccionado con anterio¬ 
ridad. 

• StateBag. La clase StateBag es el mecanismo de almacenamiento de los 
controles de servidor. Esta clase proporciona propiedades para almacenar 
información en pares clave-valor. Por ejemplo, si quiere almacenar datos 
especificados por el usuario para una página, puede usar una instancia de 
la clase StateBag para almacenar estos datos. 

Cada control de servidor incluye una propiedad EnableViewState. Cuan¬ 
do establece el valor de esta propiedad como true, el estado del control se 
conserva en el servidor entre los viajes de ida y vuelta. Así, si el usuario ha 
seleccionado una o más opciones de una lista, las opciones se guardan en el 
servidor entre los viajes de ida y vuelta. 


Resumen 

En este capítulo, ha aprendido a crear una sencilla aplicación Web mediante 
Visual C# en el entorno ASP NET. Se han estudiado los fundamentos de ASP NET 
y cómo se crean aplicaciones Web en Visual C#. 

ASP.NET incluye un entorno de tiempo de ejecución separado que gestiona la 
ejecución de las aplicaciones ASP.NET. También incluye nuevos componentes de 
servidor, llamados WebForms. que encapsulan la funcionalidad de una página 
Web. Puede agregar uno o más controles de servidor a un WebForm. Los contro¬ 
les de servidor son los responsables de mostrar los datos a los usuarios y procesar 
sus interacciones. 

Hemos creado un proyecto de aplicación Web y le hemos agregado un WebForm. 
Al crear la aplicación, usamos la plantilla ASP.NET para aplicaciones Web para 
crear una solución y agregar un proyecto ASP NET a la solución A continua¬ 
ción. diseñamos una página Web usando controles Web corrientes, como los con¬ 
troles que representan etiquetas, cuadros de texto, cuadros de listas, hipervínculos. 
botones y similares. Por último, aprendimos a controlar los eventos que generan 
los controles en el WebForm. 
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Programación 

de bases 
de datos 
con ADO.NET 


ADO.NET es la tecnología mas moderna para el acceso de datos y forma parte 
de NET Framework. ADO.NET utiliza y mejora las anteriores tecnologías de 
acceso a datos. La incursión de Microsoft en el acceso a datos universal comenzó 
con la conectividad abierta de bases de datos (ODBC). La idea sobre la que se 
asienta esta tecnología ODBC (crear un modo estándar de acceso a las bases de 
datos mediante programación) ha sido usada en todas las tecnologías de acceso a 
datos posteriores procedentes de Redmond. Washington (donde está la sede de 
Microsoft). En el caso de ODBC, este método estándar esta ejemplificado en el 
API (Interfaz de programación de aplicaciones) de ODBC Cualquier proveedor 
de bases de datos que quiera garantizar el cumplimiento del estándar ODBC debe 
elaborar el software que convierta una llamada ODBC (hecha de acuerdo eon el 
API) en una llamada de una base de datos nativa. Este software recibe el nombre 
de controlador ODBC 1 y es el puente entre una aplicación de cliente genérica y 
una base de datos específica. Mediante este enfoque, los programadores de apli¬ 
caciones evitan tener que aprender a usar el API de base de datos específico del 
proveedor. Todo lo que un programador necesita saber es cómo escribir aplica¬ 
ciones cliente usando el API de ODBC. Este hecho mejora la productividad y 
permite escribir programas que pueden ser usados con diferentes bases de datos. 

Sin embargo, el API de ODBC fue diseñado en un principio, sobre todo, con 
los programadores de C en mente y era difícil de usar en otros lenguajes (como 
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Visual Basic). Esto condujo finalmente a la creación de Objetos de datos de ActiveX 
(ADO), una tecnología de acceso a datos diseñada para ser usada con cualquier 
lenguaje compatible con el modelo de objetos componentes (COM) de Microsoft. 
ADO presenta un simple modelo de objetos que convierte el acceso a datos en los 
programas MS Windows sea una tarea sencilla. Ademas. ADO introduce el con¬ 
cepto de conjuntos de datos sin conexión como un modo de transportar datos 
entre los niveles de una aplicación distribuida. El API de bajo nivel detrás de 
ADO se llama OLE DB. Este API fue diseñado por programadores de C++ v es lo 
que los distribuidores de bases de datos suelen usar para escribir proveedores de 
OLE DB (el término más usado para referirse a los controladores OLE DB. el 
software que convierte las llamadas ADO en llamadas a bases de datos nativas). 
Microsoft también ha escrito un proveedor de OLE para OBDC. Este proveedor 
permite hacer llamadas ADO a cualquier base de datos que cumpla con el estándar 
ODBC. 

Como verá en este capítulo. ADO.NET mantiene un modelo de objetos similar 
al de ADO y mejora el concepto de conjuntos de registros sin conexión proporcio¬ 
nando un modo de reunir mas información en un objeto ADO.NET llamado con¬ 
junto de datos. De hecho. ADO.NET fue diseñado pensando en los datos sin 
conexión porque su falta de estado funciona mejor en las aplicaciones de Internet 
distribuidas. En este capitulo aprendera a usar ADO.NET para manipular datos. 
Si ya conoce ADO. muchos de los conceptos le serán familiares e incluso el 
código le puede resultar conocido. 

Clases Dataset y otras clases relacionadas 


Esta sección estudia las clases de ADO.NET. Si ya conoce ADO reconocerá 
muchos de los conceptos que aqui le presentamos. Sin embargo, tenga en cuenta 
que algunos conceptos de ADO han mejorado mucho en ADO.NET y han aumen¬ 
tado considerablemente sus formas originales. Empecemos con un nuevo concep¬ 
to: la clase DataSet y sus clases relacionadas. DataSet desarrolla el concepto 
de conjunto de registros de ADO. Los conjuntos de registros de ADO son una 
abstracción de un grupo de registros, como los datos resultantes recuperados al 
enviar una instrucción Select SQL. Un conjunto de registros puede contener 
más de un conjunto de registros, pero los registros son independientes entre sí v 
deben ser procesados secuencialmente invocando NextRecordSet () . DataSet 
de ADO.NET es una abstracción de toda una base de datos. Un DataSet no 
solo permite contener más de un conjunto de registros (llamado apropiadamente 
DataTable). sino que además puede definir relaciones entre DataTables. 
La tabla 23.1 describe todas las clases relacionadas con el DataSet. Como las 
clases ADO. las clases ADO.NET usan muy a menudo las colecciones: la clase 
DataSet contiene una colección de DataTables; la clase DataTable con¬ 
tiene una colección de DataColumns v así sucesivamente. 
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Tabla 23.1. DataSet y clases relacionadas 


Clase 

Descripción 

DataSet 

Una caché en memoria de datos, que pueden consistir 
en varias DataTables relacionadas entre sí. Está di¬ 
señada para su uso sin conexión en las aplicacio¬ 
nes distribuidas. 

DataTable 

Un contenedor de datos, que puede componerse de 
varias DataColumns . Cada fila de datos se contiene 

en una DataRow. 

DataRow 

Una fila de datos concreta en una DataTdble 

DataColumn 

La definición de una columna (nombre, datos, tipo, 
etc.) en una DataTable 

DataRelation 

Una relación entre dos DataTables de una DataSet, 
normalmente usada para representar relaciones de 
clases externas 

Constraint 

Una restricción a una o más DataColumns, usada 
para representar limitaciones como la exclusividad 

DataColumnMapping 

Asigna los nombres de columna desde la tabla de 
una base de datos hasta los nombres de columna de 

DataTable en el DataSet 

DataTableMapping 

Asigna los nombres de tabla en una base de datos 
hasta lOS nombres de DataTables en DataSet ! 

DataView 

i 

Una vista personalizada de una DataTable que pue¬ 
de usarse en la clasificación, filtrado y búsqueda. 


El RecordSet de ADO evolucionó gradualmente como el modo estándar de 
preparar los datos entre los distintos niveles de una aplicación distribuida. E\ 
DataSet asume este papel en ADO.NET y proporciona varios métodos para 
compatibilizar la cache en memoria con su fuente de datos en una base de datos. 
Estos métodos incluyen AcceptChanqes ( ) . GetChanqes ( ) . 
HasChanges ( ) . HasErrors ( ) y Re j ectChanqes ( ) . Además, permiten 
recuperar cualquier cambio en forma de un DataSet modificado, examinar las 
modificaciones en busca de errores y decidir si aceptar o rechazar los cambios. Al 
final de este proceso puede actualizar los datos fuente en la base de datos con una 
simple llamada al método Update ( ) . 

Compatibilidad con OLE DB SQL Server 

ADO.NET contiene dos conjuntos de clases similares. Una es un conjunto de 
clases genérico que puede usarse para acceder a todas las bases de datos de los 
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proveedores de OLE DB. Un segundo conjunto de clases ha sido optimizado 
para la base de datos insignia de Microsoft. SQL Server. Todos los nombres de las 
clases genéricas comienzan por OleDb. Todos nombres de las clases específicas 
de SQL Server empiezan con Sql. Cada clase genérica tiene su clase específica 
SQL Server correspondiente. Por ejemplo, la clase que se usa para ejecutar las 
instrucciones SQL en SQL Server recibe el nombre de SqlCommand. La clase 
genérica recibe el nombre de OleDbCommand. 

Este capítulo emplea las clases genéricas, incluso para acceder a la base de 
datos SQL Server. Cuando escriba sus propias aplicaciones que accedan a SQL 
Server, deberá decidir si quiere emplear las clases específicas SQL Server, mas 
rápidas, o las clases genéricas, que permiten intercambiar distribuidores cam¬ 
biando la cadena de conexión La elección se basa en velocidad o portabilidad. 
Las clases SQL Server llaman directamente al nivel nativo de la base de datos. 
Las clases genéricas usan OleDb y atrav iesan un nivel COM antes de llamar al 
nivel nativo de la base de datos. El coste de este nivel adicional supone un descen¬ 
so en el rendimiento. 

Las clases DataSet se usan en conjunción con el proveedor de OLE DB y el 
proveedor de SQL Server. La tabla 23.2 enumera las clases específicas de cada 
proveedor. Muchas de ellas le resultarán conocidas a alguien que ya ha trabajado 
con ADO 


Tabla 23.2. DataSet y clases relacionadas 


Clases de proveedores 

Descripción 

de SQL 

de OLE DB 


SqlCommand 

OleDbCommand 

Un contenedor de clase para una 
instrucción SQL. La clase puede 
administrar instrucciones directas 
SQL como las instrucciones 

SELECT, UPDATE, PELETE 0 
insert y una llamada al procedi¬ 
miento almacenado 

SqlCommandBuilder 

OleDbCommandBuilder 

Usada para generar las instruccio¬ 
nes SQL SELECT, UPDATE. DELETE 

0 INSERT. 

SqlDataConnection 

OleDbConnection 

Una conexión a una base de datos. 

SqlDataAdapter 

OleDbDataAdapter 

Un conjunto de instrucciones 

SELECT, IIPDATE, DELETE. 0 j 

insert y una conexión a una base 
de datos que puede usarse para 
completar un DataSet y actuali¬ 
zar la base de datos subyacente. 

SqlDataReader 

OleDbDataReader 

Un conjunto de registros de datos 
sólo hacia adelante. 
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Clases de proveedores 

Descripción 

de SQL 

de OLE DB 


SqIError 

OleDbError 

Un aviso o error devuelto por la 
base de datos, perteneciente a una 
colección Errors. 

SqIException 

OleDbException 

El tipo de excepción iniciado cuan¬ 
do ocurren errores en la base de 



datos 

SqlParameter 

OleDbParameter 

Un parámetro para un procedimien¬ 
to almacenado. 

SqlT ransaction 

OleDbT ransaction 

Una transacción de base de datos. 


En la siguiente sección estudiaremos el modo en el que estas clases trabajan 
con las clases comunes. DataSet y sus clases relacionadas, para realizar opera¬ 
ciones con las bases de datos comunes. 


Operaciones de bases de datos comunes 
mediante ADO.NET 


Cada uno de los ejemplos de esta sección omite las declaraciones using en 
beneficio de la sencillez. Se supone que las siguientes tres declaraciones de espa¬ 
cio de nombres están presentes en este capítulo: 

• using System; 

• using System.Data; 

• using System.Data.OleDb; 

Además, muchas funciones se han sacado del contexto de su clase Se supo¬ 
ne que las funciones están incluidas en el ámbito definido por la siguiente defini¬ 
ción de clase: 

ñamespace ADOdotNET 

{ 

class ADOdotNET 
{ 

// NOTA: Coloque aquí la función 
} 

} 

Una vez hechos estos comentarios previos, podemos adentrarnos en ADO NEI 
Una a una. esta sección examina cada categoría de operaciones que puede reali¬ 
zarse con ADO NET: 
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• Operaciones que no devuelven filas. 

• Operaciones que sólo devuelven una fila. 

• Operaciones que sólo afectan a una fila. 

• Operaciones que devuelven varias filas. 

• Operaciones que afectan a varias filas. 

• Operaciones que devuelven datos jerárquicos. 

Operaciones que no devuelven filas 

Muchas operaciones de SQL (por ejemplo, las instrucciones Insert. Delete 
v Update) devuelve solo éxito o fracaso (o los números de filas afectados por la 
operación). 


NOTA: El programador de SQL Server controla si el número de filas afec¬ 
tadas se devuelve desde un procedimiento almacenado mediante la instruc¬ 
ción SET NOCOUNT [ON | OFF] . Los programadores en SQL Server 
suelen desactivar esta característica mediante SET NOCOUNT ON porque 
mejora ligeramente el rendimiento. 


El listado 23.3 muestra lo sencillo que resulta ejecutar una instrucción SQL 
que no devuelve filas en ADO.NET. En este proceso se emplean dos objetos. En 
primer lugar se usa un objeto OleDbConnection para establecer una co¬ 
nexión con una base de datos. El listado 23.1 muestra un ejemplo de cadena de 
conexión usada para acceder a la base de datos Northwind de una instrucción de 
SQL Server instalada localmente. 

Listado 23.1. Ejemplo de cadena de conexión para SQL Server 

prívate static string oleDbConnectionSt ring 
{ 

ge t 
{ 

// NOTA: Usar la cuenta sa para producir 
// aplicaciones es, por supuesto, una práctica 
// muy mala. Ademas, dejar en blanco la 
// contraseña para la cuenta sa es igualmente 
/ / inadmisib1e. 

return "Provider=SQLOLEDB.1;" 

+"User ID=sa;Initial Catalog=Northwind;Data 
Source = localhost; ” ; 

} 

} 

El listado 23.2 muestra un ejemplo de cadena de conexión para Access 2000. 
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Listado 23.2. Ejemplo de cadena de conexión para Microsoft Access 


prívate static string oleDbConnectionString 


ge t 

{ 

// NOTA: Se presupone que se ínstalo 

// Microsoft Office Pro en el directorio por defecto, 
return "Provider-Microsoft.Jet.OLEDB.4.0; " 

+"Data Source=C:WProgram Files \\Micr osoft 
Of f ice\\Of f ice\\Sampies WNorthwind . MDB" ; 

} 


El segundo objeto que se usa para ejecutar una consulta es OleDbCommand. 
Su constructor recibe un argumento de cadena (el texto de la instrucción SQL que 
se quiere ejecutar) v un objeto O 1 e DbC o n ne c t i o n . La propiedad 
CommandType permite especificar si el comando que se ejecuta es un procedi¬ 
miento almacenado, una consulta Access o texto simple. La consulta se realiza 
mediante el método ExecuteNonQuery ( ) . Los errores, como una infracción 
de clave primaria, se notifican mediante excepciones. 

También se pueden usar objetos Command para ejecutar comandos SQL que 
no devuelven filas de datos, como en el ejemplo del listado 23.3: 

Listado 23.3. Plantilla para usar un comando y ejecutar una instrucción SQL que no 

devuelve filas 

// Declare y asigne los valores apropiados para 
oleDbConnectionString y strSQLStatement 
// Crea objetos OleDb 

01eDbConnection databaseConnection = new 
01eDbConnection(oleDbConnectionString); 

OleDbCommand databaseCommand = new 

OleDbCommand{strSQLStatement, databaseConnection); 

// NOTA: Solo se debe usar una de las dos instrucciones que se 
muestran a continuación, NO AMBAS. 

// Si estamos tratando con una instrucción SQL (es decir, NO 
con un procedimiento almacenado), use: 

databaseCommand.CommandType = CommandType.Text; 

// Si estamos tratando con procedimiento almacenado, use: 

databaseCommand.CommandType = CommandType.StoredProcedure; 
t r y 
{ 

// Establece la conexión de base de datos 
databaseConnection.Open(); 

// Ejecuta el comando de SQL 

int numRows = databaseCommand.ExecuteNonQuery(); 

// Haz otra cosa, p. ej. informar sobre numRows 

} 

catch (Exception e) 

{ 
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//Controla la excepción, p. ej . : 

Consolé . Wr iteLine $<* + + * + **■ Caught an except ion : \n { 0 } " , 
e.Me s s age) ; 

} 

f i n a 11 y 

{ 

el a t a b a s e C onn e c t i on . C1 o s e () ; 

} 

La invocación de procedimientos almacenados con parámetros es un poco 
más complicada. El listado 23.4 muestra el codigo SQL para un procedimiento 
almacenado al que se quiere llamar. 

Listado 23.4. Un procedimiento almacenado de SQL Server para insertar 

un registro 

USE [Northwindf 
GO 

CREATE PROCEDURE [pe insCustorners ] 

(@Cus t orne rID_1 [nchar] (5), 

@CorripanyName 2 [nvarchar] (40) , 

0Cont actNair.e 3 [nvarchar] (30) , 

@ContactTit1e_4 [nvarchar] (30), 

@Address 5 [nvarchar] (cO) , 

@City c [nvarchar] (15) , 

@Region _ 7 [nvarchar] (15) , 

@Posta1Code o [nvarchar] (10) , 
pcountry 9 [nvarchar] (15) , 

0Phone 10 [nvarchar](24), 

0Fax 11 [nvarchar] Í24)f 
AS 

INSERT I NT O [Northwmd] . [dbo] . [ Cus t orne rs ] 
í [Cus torne rID J , 

[Co mpa n y Na me ] , 

[ContactName] , 

[ CentactTitle], 

[Add r e s s¡ , 

[ C 1 1 y ] , 

[Re gion] , 

[Post a 1Code J , 

[ C o u n t r y ] , 

[Phone J , 

[Fax]) 

VALUES 

( 0Cus t orne r T D 1, 

@ Comp a ny N ame 2, 

0 C o n t a c t M ame 3 , 

0 C o n t a c t T 1 11 e _ 4 , 

0Address 5, 

0 C 1 1 y_r, 

0 R e qion 7, 

0Post a 1Code 8, 




@Country_9, 

@Phone_ 10, 

0 Fax 11) 

La única parte complicada es saber cómo definir y establecer los parametros. 
Esto se hace mediante la colección Parameters. Como en cualquier colección, 
los nuevos miembros se crean con el método Add ( ) . El parámetro recién creado 
es devuelto y se puede establecer la dirección (tanto si el parametro se usa solo 
para introducir datos, para salida de datos o para ambas operaciones) y el valor. 
Los parámetros del método Add ( ) son el nombre del parametro del procedimien¬ 
to almacenado, su nombre, su tipo de datos y su tamaño. El listado 23.5 muestra 
el código para todo el proceso. 

Listado 23.5. Cómo llamar a un procedimiento almacenado con parámetros 

en ADO.NET 


static void Tes 11nser tWithS PS t a t emen t (stnng cus t orne r T D ) 

i 

// Establece la cadena de instrucción SQL 
stnng strSQLlnsert. - " [ pc_ i nsCus t orne r s ] " ; 

// Crea objetos OleDb 

OleDbConnect ion databaseConnection new 
OleDbConnecti on f ol e DbConn e c t ion S t ring.; ; 

01 e D b C ominan d inserte omina n d = n e w 01 e I) b C omma n d í s t r S Q L1 n s ert, 
databaseConnection); 

/ / E s t a rao s trata n do con un a p r o c e d mu e n t o a 1 ma c en a d o ( e s d e c 11 , 
N O c on una instrucción S Q L) 

inse rtCommand.CommandType = CommandType.St o redPiocedu r e ; 

// Agregue cada parametro (i de Md 
OleDbParameter param = 

insertCommand . Pa r ame te rs . Add ( " 0Cus t orne r I L_ JfTjs: 

01eDbType.VarChar , 5); 

pa ram. Direct i on - Paramete rDirect. ] on . Input; 
param.Valué = customerID; 

// Agregue cada parametro (#2 de 11) 

param = inse rtCommand . Paramete r s . Add |T @ C omp a n y N a me__ 2 " , 

01 eDbType.VarChar , 40); 

param.Direct i on = ParameterDirection.Input/ 
param.Va lúe = "Hungry Coyote Export Store"; 

// Agregue cada parametro 3-10 
// Etc. 

// Agregue cada parametro (ii de 11) 

param = i ns e rtCommand .Parameters. Add ( " @ Fa 11", 

OleDbType.VarChar, 24); 

param.Direction = ParameterDirection.Input; 
param.Valué - " ( 503) 555-2376"; 

try 
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{ 

// Establezca la conexión de la base de datos 
da t. abas eC onne c t. i on . Open í ! | 

// Ejecute el comando SQL 

int numPows - in.se rt.Command . Execut eNonQuer y () ; 

// I nforme de los resultados 
Conso 1 e . Wr .i teLme í " Tnserted { 0 } row ( s j . " , 
numPows . ToSt ring ( ) ) 

} 

ca t ch (Excepti on e) 

1 

Conso 1e.Write Jo ne ( " w * * * * Caught an exception:\n{ú}", 
e . M e s s a y e j ; 

} 

final 1 y 


1 

} 


1 o n n e c t 


.Cióse ! } ; 


Operaciones de datos que devuelven entidades 
de fila única 

Algunas operaciones de datos, como recuperar un registro basado en una clave 
primaria, solo devuelven una fila. ADO.NET proporciona tres modos de recupe¬ 
rar una sola fila. Un modo solo se apliea a las entidades de fila única y los otros 
dos modos son genéricos y pueden ser usados para recuperar varias filas (como 
verá en la siguiente sección). 

El modo mas eficiente de recuperar una entidad de fila única suele ser median¬ 
te un parametro de salida. Sin embargo, este método sólo se puede usar cuando se 
esta seguro de que el procedimiento devuelve una sola fila. El listado 23.6 mues¬ 
tra un procedimiento SQL Server almacenado que recupera un único registro 
mediante parámetros de salida. 

Listado 23.6. Un procedimiento SQL Server almacenado para recuperar un único 

registro 


tilfj E ¡ Mo r t hw i bfi ] 

GC 

CPEATE PP r A ;Efi V PE f Po yetCon t act ByCustorner I D ] 
i0Custorno r I b i |nc bar] ( 5! , 

@G on t a r t Ií'amo_f [ nvarchar] ( 3 O ) output, 

@ C..: o n t a c t 7 i r. 1 e 3 [ n v a r c h a r j í 3 O ) o u t p n t.) 

SELECT 

@Conta fj tName_2 - [Con t ac t Name] , 

0ContaotTitle_3 - [ContactTitle] 
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FROM [Northwind].[dbo].[Customers| 

WH ERE 

[CustomerID] = @CustomerID 1 

La invocación de este procedimiento almacenado es similar al código usado 
para llamar al procedimiento almacenado que inserta una fila (véase el listado 
23.3).Por supuesto, la dirección para los parámetros de salida se establece en 
ParameterDirect ion . Output . Tras ejecutar el procedimiento almacena¬ 
do. puede usar la colección Parameters para recuperar los valores de los 
parámetros de salida, como muestra el listado 23.7. 

Listado 23.7. Cómo recuperar un único registro mediante parámetros de salida 


static void TestSPWithOutParamfstring customerlD). 


// Establezca las cadenas de la instrucción S QL 
string strSQLSelect -- " [pc_getCont act ByCust. orne r T D ] " ; 

// Cree objetos OleDb 

OleDbConnection databaseConnection - new 
uleDbConnect ion (oleDbConnect. íonStrmg) ; 

OleDbComraand selectooiranand - new OleDbComman d ( st r SQLSe 1 e c t , 
dat. abas eConne c t i on) ; 


// Estamos tratando con un procedimiento almacenado (es 
decir, NO una instrucción SQL) 

selectCommand.CommandType - CommandType.StoredProcedure; 


// Agregue cada parametro (i de 3) 

01 eDbParameter param = 

se1ectCommand.Parameters.Add("@CustomerID_i", 

OleDbType.VarChar , 5); 

param.Direction - ParameterDirection.Input; 
param.Valué - customerlD; 

// Agregue cada parametro (2 de 3) 

param - selectCommand.Parameters.Add("@ContactName 
OleDbType.VarChar, 30) ; 

param.Direction = ParameterDirection.Output; 

// Agregue cada parametro (3 de 3) 

param = selectCommand.Parameters.Add("@ContactTitle 
OleDbType.VarChar, 30); 

param.Direction = ParameterDirection.Output; 


t r y 


// 

Establez 

ca 

la conexión de l«a 

dat 

;abaseConnec 

: tion.Open ( ) ; 

// 

Ejecute 

el 

comando SQL 

s e J 

LectCommand. 

. ExecuteNonQuer y() 

// 

Informe 

de 

los resultados 
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strincj contactName = 

s e 1 ect C omina nd . Paramete rs [ " @Cont actName_2 "] .Valué . ToString ( ) ; 
string contactTitle m 

selectCommanci.Parameters["@ContactTitle_3" ] .Valué.ToString () ; 

Consolé.WriteLine("Contact ñame is {0}, title is {!}.", 
contactName, contactTitle); 

} 

catch (Ezception e) 

{ 

Consolé .WriteLine (''****** Caught an exception: \n{0} ", 
e . M e s s a g e ) ; 

} 

f i n a 11 y 

{ 

dat abas eC orine ct ion .Cióse ( ) ; 

} 

} 

Observe a hora los métodos genéricos de lectura de datos. El primero usa un 
objeto OleDbDataReader. El objeto Command tiene un método 
EzecuteReader ( ) . que devuelve un objeto OleDbDataReader. A conti¬ 
nuación puede usar el método Read ( ) para recorrer el contenido del DataReader 
Read ( ) devuelve True cuando se encuentran datos durante la lectura y False 
en caso contrario. El listado 23.8 muestra cómo hacerlo. Observe que este ejem¬ 
plo usa una instrucción SQL para acceder a un procedimiento almacenado solo 
para mostrar un modo alternativo de llamar a un procedimiento almacenado. Esto 
sólo se hace con fines demostrativos, ya que es más eficiente llamar a un procedi¬ 
miento almacenado de la forma que se muestra en el listado 23.7. 

Listado 23.8. Cómo recuperar un registro único mediante DataReader 

static void TestSelectWithDataReader(string customerID) 

{ 

// Establezca las cadenas de instrucción SQL, dando por 
sentado que customerID no contiene comillas 

string strSQLSelect = "EXEC [pc_getCustomer_ByCustomerID] 
@Cust.omerID 1 = ' " + customerID + " '" ; 

// Cree objetos OleDb 

OleDbConnection databaseConnection = new 
01eDbConnection(oleDbConnectíonString); 

OleDbCommand se1ectCommand = new OleDbCommand(strSQLSelect, 
databaseConnection); 

// Estamos tratando con una instrucción SQL (es decir, NO con 
un procedimiento almacenado) 

se1ectCommand.CommandType = CommandType.Text; 

try 

{ 

// Establezca la conexión de la base de datos 
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databaseConnection.Open ( ) ; 


// Ejecute el comando SQL 

OleDbDat aReade r rowReader = se 1ectCommand.ExecuteReader () t 

// Informe de los resultados 
íf ( rowReader.Read() ) 

{ 

string contactName = 
rowReader["ContactName"].ToString(); 

string contactTitle = 
rowReader["ContactTitle"].ToString{); 

Consolé .Wr i teLine ( "Contact; ñame is {0}, tifie is 
contactName, contactTitle); 

} 

e 1 s e 
{ 

Consolé.WriteLine("No rows f ound!") ; 


catch (Exception e) 

{ 

Console.WriteLine("** + *** Caught an exception:\n{0}", 
e.Message); 

} 

f i n a 11 y 
I 

databaseConnection.Cióse ( ) ; 

) 


El otro método genérico de recuperar datos es mediante el versátil objeto 
DataSet. Como el objeto DataSet fue diseñado para ser usado independien¬ 
temente de la fuente de datos que lo origino, no hay OleDbDataSet ni 
SqlDataSet. solo un DataSet. Un DataSet se usa en conjunción con un 
DataAdapter . Un objeto DataAdapter se usa específicamente para alma¬ 
cenar datos (es decir, se usa OleDbDataAdaper ) y contiene cuatro objetos de 
comando para realizar operaciones: 

• TnsertCommand 

• SelectCommand 

• UpdateCommand 

• DeleteCommand 

Tras seleccionar el objeto SelectCommand se puede emplear el método 
Fill ( ) para completar un DataSet. La siguiente sección muestra cómo usar 
los otros tres comandos para modificar los datos que contiene un DataSet. Un 
DataSet contiene uno o más objetos DataTable. Cada DataTable contic- 
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ne uno o más objetos DataRow. Estos objetos DataRow se almacenan en la 
colección Rows del DataSet. Un objeto DataRow contiene uno o más objetos 
DataColumn. Estos objetos DataColumn se almacenan en la colección 
Columns del DataRow. Las colecciones Row y Column son indizadas me¬ 
diante el índice y el nombre. De hecho, puede imaginar el objeto DataSet como 
una base de datos en memoria. El listado 23.9 muestra un programa de ejemplo 
que recupera un único registro usando un objeto DataSet. 

Listado 23.9. Cómo recuperar un registro único mediante DataSet 

static voicl TestSelectWithDataSet (string customerID) 

{ 

// Establezca las cadenas de instrucción SQL 
string strSQLSelect - "EXEC [pc_getCus tome r_ByCust orne rID] 
^CustomerID 1='" + customerID + "'"; 

// Cree objetos OleDb 

Ole DbConnec1 1 on databaseConnection = new 
OleDbConnection(oleDbConnectionString); 

OleDbCommand se 1ectCommand = new OleDbCommand(strSQLSelect, 
databaseConnection); 

OleDbDataAdapter dsCmd = new OleDbDataAdapter(); 

DataSet resultDataSet - new DataSet{); 

// Estamos tratando con una instrucción SQL (es decir, NO con 
un procedimiento almacenado) 

selectCommand.CommandType = CommandType.Text; 

t r y 

{ 

// Establezca la conexion de la base de datos 
databaseConnection.Open(); 

// E j ecute el comando SQL 

dsCmd.Se 1ectCommand = selectCommand; 

int numRows = dsCmd.Fill(resultDataSet, "Customers"); 

// Informe de los resultados 
if (numRows > 0) 

{ 

string contactName - resultDataSet.Tables["Customers" ] . 

Rows [ 0 ] ["ContactName "] .ToStnng () ; 

string contactTitle = resultDataSet.Tables["Customers"1. 
Rows [0J ["ContactTitle"] .ToStnng () ; 

Consolé .WriteLine("Contact ñame ís {0}, title ís {1}.", 
contactName, contactTitle); 

} 

e 1 s e 

{ 

Consolé.WriteLine("No rows found!"); 




catch (Exception e) 


{ 

Consolé.WriteLine("****** Caught an exception:\n{0}", 
e.Message); 

} 

finally 
{ 

databaseConnection.Cióse { ) ; 


Operaciones de datos que afectan 
a las entidades de fila única 

Esta sección estudia las propiedades InsertCommand. UpdateCommand 
v DeleteCommand del objeto DataAdapter . Para cada uno de estos coman¬ 
dos se puede establecer el comando mediante programación o se puede generar 
automáticamente. El primer método suele dar como resultado un mejor rendi¬ 
miento porque supone menos encabezados. 

Operaciones de introducción de datos que afectan 
a las entidades de fila única 

El código del listado 23.10 usa un idioma automático que es útil para generar 
automáticamente instrucciones Insert. Mediante SelectCommand se consi¬ 
gue un DataSet vacío. Esta llamada Fill() solo sirve para recuperar la 
estructura de las filas que quiere manipular. Esto es más flexible que definir la 
estructura mediante programación. 

El secreto para generar automáticamente comandos DataAdapter es crear 
un objeto CommandBuilder que usa el DataAdapter como un argumento 
en el constructor, como muestran las siguientes líneas: 

// ¡¡¡La siguiente linea es clave para generar instrucciones 

automáticamente!!! OleDbCommandBuilder custCB - new 

OleDbC ommandBuilde r (dsCmd) ; 

Sin estas líneas, la posterior instrucción Update ( ) funcionará mal porque 
InsertCommand no puede generarse automáticamente. Las operaciones gene¬ 
radas automáticamente UpdateCommand y DeleteCommand tienen los mis¬ 
mos requisitos. 

El listado 23.10 muestra todo el procedimiento en funcionamiento. Tras re¬ 
cuperar la estructura de la tabla Customers mediante un procedimiento alma¬ 
cenado (que aparece en el listado 23.11). se crea una nueva fila mediante una 
llamada al método NewRow ( ) . A continuación se asigna un valor a cada colum¬ 
na de la nueva fila y esa fila recién completada se agrega a la colección Rows 
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mediante una llamada al método AddRow ( ) . Finalmente, este cambio se envía a 
la fuente de datos creada mediante una llamada del DataAdapter al método 
Update() . 


Listado 23.10. Cómo agregar un registro único mediante un comando 
InsertCommand generado automáticamente 

static void TestAutoInsertWithDataSet(string customerID) 

i 

// Establezca las cadenas de instrucción SQL, solo 
necesitamos los metadatos de modo que 

// ningún registro concuerde con este CustomerID. 
string strSQLSelect - "EXEC [pe getCustomer ByCustornerID ] 

@Custorne rID 1; 

// Crea objetos OleDb 

OleDbConnection databaseConnection - new 
OleDbConnection(o ieDbConnec1 1 onString} ; 

OieDbCommand selectCommand = new OleDbCommand(strSQLSelect, 
databaseConnection); 

OleDbDataAdapter dsCmd = new OleDbDataAdapter(); 

// § ¡ ¡La siguiente linea es clave para generar instrucciones 

automáticamente!!! 

01eDbCommandBui 1 der custCB = new OleDbCommandBuilder(dsCmd); 
DdtdSet resul tDataSet - new DataSet () ; 

// Estamos tratando con una instrucción SQL (es decir, NO con 
un procedimiento almacenado) 

selectCommand.CommandType - CommandType.Text ; 

try 

í 

// Establezca la conexión de la base de datos 
databaseConnection.Open(); 

// Ejecute el comando SQL 

dsCmd.Se 1ectCommand = selectCommand; 

// Recupera la estructura de la tabla Custorners 

int numRows = dsCmd.Fi11 (resultDataSet, "Customers'j ; 

// Cree una nueva fila 
D a t a R ow workR ow = 

result.Dat.aSet . T a b 1 es [ " C u s t orne r s " ] . N e wRow ( ) ; 

// Complete los datos workrow 

workRow["CustomerID'4 = customerID; // 1 

workRow["CompanyName " ] = "Hungry Coyote Export Store"; 

// 2 

workRow["ContactName"] = "Yoshi Latimer"; // 3 

workRow["ContactTit1e"] - "Sales Representative"; // 4 

workRow["Address"] - "City Center Plaza 516 Main St." ; 

// 5 
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// 8 


workRow["City"] = "Elgin"; // 6 

workRow["Región"] = "OR"; // 7 

workRow["PostalCode"] = "97827"; 

workRow["Country"] = "USA"; // 9 

workRow["Phone"] = "(503) 555-6874"; // 10 

workRow["Fax"] = "(503) 555-2376"; // 11 

resultDataSet.Tables["Customers"].Rows.Add(workRow); 

// C omp atibilice los cambios con la fuente de datos 
dsCmd.Update(resultDataSet, "Customers")I 

// Informe de los resultados 
Consolé .WriteLme (" Inserted 1 row."); 

} 

catch (Exception e) 

{ 

Consolé.WriteLine("**** * * Caught an exception:\n{0}", 
e.Message); 

} 

fina1ly 
{ 

databaseConnection.Cióse ( ) ; 


} 


Listado 23.11. Procedimiento almacenado para recuperar la estructura de la tabla 

Customers 


USE [Northwind] 

GO 

CREATE PROCEDURE [pc_getCustorner_ByCustorner ID] 

(@CustomerID_1 [nchar] (5) ) 

AS 

SELECT 

[ Custome rID ] , 

[CompanyName], 

[ContactName], 

[ContactTitle], 

[Addres s] , 

[City], 

[Región], 

[ PostalCode] , 

[Country ], 

[ Phone] , 

[Fax] 

FROM [Northwind].[dbo].[Customers] 

WHERE 

[CustomerID] = @CustomerID_1 

Hay que definir mediante programación un comando que realice la introduc¬ 
ción de datos. Ya aprendió a hacerlo con un procedimiento almacenado con 
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parámetros (por cierto, uno de los modos más eficientes de realizar operaciones 
con datos) en el listado 23.5. Tras definir el comando y sus parámetros, todo lo 
que debe hacer es establecer el InsertCommand de DataAdapter. como 
muestra el listado 23.12. El resto del código (crear una nueva fila, dar valores a 
las columnas, agregar la nueva fila y actualizar el código fuente) es igual que el 
codigo usado para un InsertCommand generado automáticamente. Como se 
usa un enfoque igual a la creación manual de un comando para UpdateCommand 
v DeleteCommand. la siguiente sección solo muestra cómo usar los comandos 
generados automáticamente. 

Listado 23.12. Cómo agregar un registro único mediante InsertCommand 

st.atic void Tes t DataSet InsertCommand ( st ring customerlD) 

{ 

// Establezca las cadenas de instrucción SQL 
string strSQLSelect - "EXEC [pc_getCustomer_ByCustomerID] 

@ C u s t. orne r ID 1; 

string strSQLInsert = " [pc_insCustomers] "; 

// Cree objetos OleDb 

O i e DbConnection databaseConnection = new 
01 eDbConncct i on.ffeleDbConne ct i onS t r ing) ; 

OJ e D bCominand selectCommand = new OleDbCommand (strSQLSelect , 
databaseC o n nection) ; 

OI eDbDat. aAdapt.er dsCmd - new OleDbDataAdapter ( ) ; 

DataSet result.DataSet ■= new DataSet ( ) ; 

// Estamos tratando con una .instrucción SQL (es decir, NO con 
un procedimiento almacenado) 

selectoornmand . CommandType = CommandType . Text ; 

OleDbCommand InsertCommand = new OleDbCommand(strSQLInsert, 
databaseC onr.ee t. i on ) ; 

InsertCommand.CommandType = CommandType.StoredProcedure; 
inse r tCommand . CommandText = " [ pc_msCus t orne r s ] 

insertCommand.Connection - databaseConnection/ 

// Agregue cada parametro (1 de 11) 

OleDbParameter param = 

inserteommand.Parameters.Add("@CustomerID_1" , 

OieDbType.VarChar, 5); 

param.Direction = ParameterDirection.Input; 
param.SourceColumn - "CustomerlD"; 

// Agregue cada parametro (2 de 11) 

param - inse rtCommand.Parameters.Add("@CompanyName_2", 
OieDbType.VarChar, 40); 

pa r am. Di r ect. i on = ParameterDirection. Input; 
pa r am.SourceColumn = "CompanyName 
// Agregue cada parametro 3-10 
// Etc. 

// Agregue cada parametro (11 de 11) 
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param = insertCommand.Parameters.Add("@Fax_l1", 

OleDbTvpe.VarChar, 24); 

param.Direction = ParameterDirection.Input; 
parara.SourceColumn - "Fax"; 

t r y 

{ 

// Establezca la conexión de la base de datos 
databaseConnection.Open ( ) ; 

// Ejecute el comando SQL 

dsCmd.Se1ectCommand = selectCommand; 

dsCmd.InsertCommand = insertCommand; 

int numRows = dsCmd. Fill (resultDataSet. , "Cus tome r s " ) ; 

// Cree una nueva fila 
DataRow workRow = 

resultDataSet.Tables["Cus torne rs"] .NewRow() ; 

// Complete los datos workrow 

workRow["CustomerID" ] = customerID; // 1 

workRow["CompanyName" ] = "Hungry Coyote Export Store" 

// 2 

workRow["ContactName" ] = "Yoshi Latimer"; // 3 

workRow["ContactTitle"] = "Sales Representative"; 

workRow["Address"] = "City Center Plaza 516 Main St . " 

// 5 

workRow["City"] = "Elgin"; // 6 

workRow["Región"] = "OR"; // 7 

workRow["PostalCode"] = "S7827"; // 8 

workRow["Country"] = "USA"; // 9 

workRow["Phone"] = "(503) 555-6874"; // 10 

workRow["Fax"] - "(503) 555-2376"; // 11 

resultDataSet.Tables["Cust orners"] .Rows.Add(workRow) ; 

// Compat ibi 1 i ce los cambios con la fuente de datos 
dsCmd.Update(resultDataSet, "Custorners"); 

// Informe de los resultados 
Consolé.WriteLine("Inserted 1 row."); 

} 

catch (Exception e) 

{ 

Consolé.WriteLine("**** Caught an exception:\n{0}", 
e.Message); 

} 

finally 

{ 

databaseConnection.Cióse() ; 

} 


// 4 
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Operaciones de actualización que afectan a entidades 
de fila única 

Para realizar operaciones que tienen lugar mediante un DataSet. obviamen¬ 
te es necesario recuperar antes la fila que se quiere modificar. Por tanto, no es 
necesario el truco sugerido para la instrucción Insert. Tras recuperar un 
DataSet. se puede simplemente actualizar una columna de una fila especifica. 
En ese momento se puede llamar al método Update () de DataAdapter para 
propagar los cambios en la fuente de datos. Por ahora, el contenido del listado 
23.13 le resultará conocido. Como se señaló en la sección anterior, el no usar 
instrucciones generadas automáticamente solo significa que deberá crear manual¬ 
mente un comando que controle la instrucción Update. 

Listado 23.13. Cómo actualizar un registro único mediante un UpdateCommand 

generado automáticamente 

static void TestAutoUpdateWithDataSet (stnng customerID) 

{ 

// Establezca las cadenas de instrucción SQL 

string strSQLSelect = M EXEC [ p c_g e t Cu s t orne r _By Cus t orne r ID] 
@CustomerID_1-' " + customerID + " ' "; 

// Cree objetos OleDb 

OleDbConnection databaseConnection = new 
OIe DbConne ction(oleDbConnectionString) ; 

OleDbCommand se1ectCommand = new OleDbCommand(strSQLSelect, 
databaseConnection); 

OleDbDataAdapter dsCmd = new OleDbDataAdapter() ; 

// ¡¡¡La siguiente linea es clave para generar instrucciones 

automáticamente!!! 

OleDbCommandBuilder custCB = new OleDbCommandBuilder(dsCmd); 

DataSet resultDataSet - new DataSet (); 

// Estamos tratando con una instrucción SQL (es decir, NO con 
un procedimiento almacenado) 

selectCommand.CommandType = CommandType.Text; 

t r y 

{ 

// Establezca la conexión de la base de datos 
databaseConnection.Open {) ; 

// Ejecute el comando SQL 

dsCmd.SelectCommand = selectCommand; 

int numRows = dsCmd.Fi1 ti resultDataSet, "Custorners"); 

// Informe de los resultados 
íf (numRows > 0) 

( 

resultDataSet.Tables["Customers"].Rows[0]["ContactTitle"] 

"Sr . Sales Representative" ; 
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// Compatibilice los cambios con la fuente de datos 
dsCmd.Update(resultDataSet, "Customers"); 

Consolé . WriteLine ( " 1 row updated!"); 

} 

e 1 se 

{ 

Consolé.WriteLine("No rows found!"); 


catch (Exception e) 

{ 

Consolé.WriteLine("* ***** Caught an exception:\n{0}", 
e.Message); 

} 

f i n a 11 y 

{ 

databaseConnection.Cióse () ; 

} 


Operaciones de borrado que afectan a las entidades 
de fila única 

Por supuesto, no todas las operaciones que afectan a las entidades de fila única 
deben realizarse mediante un DataSet. También se puede usar un procedi¬ 
miento almacenado o una instrucción SQL. El listado 23.14 muestra como usar 
una instrucción SQL para borrar una fila única en una tabla. 

Listado 23.14. Cómo borrar un registro único mediante una instrucción SQL 

static void TestDeleteStatement(string customerID) 

{ 

// Establezca las cadenas de instrucción SQL 

string strSQLDelete = "DELETE FROM Customers WHERE CustomerID 
= '" + customerID + " 

// Cree objetos OleDb 

OleDbConnection databaseConnection - new 
OleDbConnection(oleDbConnectionString); 

OleDbCommand deleteCommand = new OleDbCommand(strSQLDelete, 
databaseConnection); 

// Estamos tratando con una instrucción SQL (es decir, NO con 
un procedimiento almacenado) 

deleteCommand.CommandType = CommandType.Text; 

t r y 

{ 

// Establezca la conexión de la base de datos 
databaseConnection.Open(); 
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// Ejecute el comando SQL 

int numRows = deleteCommand.ExecuteNonQuery(); 

// Informe de los resultados 
Consolé .WnteLme ("Deleted {0} row(s) 
numRows.ToSt ring() ) ; 

} 

catch (Exception e) 

{ 

Consolé.WnteLme (" + ** + *+ Caught an exception: \n|l} " , 
e . M e s s a g e ) ; 

} 

final I y 

{ 

databaseConnection.Close(); 

} 

} 

El listado 23.15 finaliza con el estudio de los comandos generados 
automáticamente, mostrándole cómo borrar una fila única usando este sistema. 
Tras completar un DataSet. puede eliminar una fila con una llamada Delete ( ) . 
Como siempre, se necesita una llamada Update { ) para fijar este cambio en la 
fuente de datos. 

Listado 23.15. Cómo borrar un registro único con un DeleteCommand generado 

automáticamente. 

static void TestAutoDeleteWithDataSet(string customerID) 

{ 

// Establezca las cadenas de instrucción SQL 
string strSQLSelect = "EXEC [pc_getCustorner_ByCustornerID] 
@CustomerID_1 =' " + customerID + 

// Cree objetos OleDb 

OleDbConnection databaseConnection = new 
01eDbConnection(oleDbConnectionString); 

01eDbCommand selectCommand - new OleDbCommand(strSQLSelect, 
databaseConnection); 

01eDbDataAdapter dsCmd - new OleDbDataAdapter() ; 

// ¡i¡La siguiente linea es clave para generar instrucciones 

automáticamente!!! 

01eDbCommandBuilde r custCB = new OleDbCommandBuilder(dsCmd); 
DataSet resultDataSet = new DataSet(); 

// Estamos tratando con una instrucción SQL (es decir, NO con 
un procedimiento almacenado) 

selectCommand.CommandType = CommandType.Text; 

t r y 

{ 

// Establezca la conexión de la base de datos 
databaseConnection.Open {) ; 
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// Ejecute el comando SQL 

dsCmd.SelectCommand = selectCommand; 

int numRows - dsCmd.Fill(resultDataSet, "Gustómers"); 

// Informe de los resultados 
if (numRows > 0) 

{ 

resultDataSet.Tables ["Cus torne rs"J .R ows [0] .Delete () ; 

// Compatibi1iza los cambios con la fuente de datos 
dsCmd.Update(resultDataSet, "Cust omers") ; 

Consolé.WriteLinc("1 row deleted!"); 

} 

e 1 s e 

{ 

Consolé .WriteLme ( "No rows found!"); 

} 

} 

catch (Exception e) 

{ 

Console.WnteLine ("*****+ Caught an exception : \n { 0 }" , 
e . M e s s a g e ) ; 

} 

f i n a 11 y 

{ 

databaseConnection.Close () ; 



Operaciones de datos que devuelven conjuntos 
de filas 

Ya vimos dos maneras de recuperar conjuntos de filas cuando explicamos 
cómo recuperar una fila única. El listado 23 16 usa un procedimiento almacenado 
para explicar la recuperación de un conjunto de filas. Usa una instrucción TOP 5 
para mantener el número de filas devueltas en un número aceptable La única 
diferencia reseñable entre el listado 23.17 y el listado 23.X es el uso del bucle 
while (en lugar de la instrucción if) para recorrer todos los registros. 

Listado 23.16. Procedimiento almacenado SQL Server para seleccionar un conjunto 

de registros 


USE [Northwind] 

GO 

CREATE PROCEDURE [pc_getCustomers] 
AS 

SELECT TOP 5 

[CustomerID], 

[CompanyName] , 
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[Cont actName] , 

[ContactTitle], 

[Address], 

[City], 

[Región], 

[PostalCode], 

[Country], 

[Phone], 

[Fax] 

FROM [Northwind].[dbo].[Customers] 

Listado 23.17. Cómo recuperar un conjunto de registros con DataReader 

static void TestSelectManyWithDataReader(string custornerID) 

{ 

// Establezca las cadenas de instrucción SQL 
string strSQLSelect = " [pc_getCustomers] "; 

// Cree objetos OleDb 

01eDbConnection databaseConnection = new 
OleDbConnection ( o1eDbConnec1 1 onString) ; 

01 eDbCommand selectCoirunand - new OleDbCommand (strSQLSelect, 
databaseConnection); 

// Estamos tratando con procedimientos almacenados (es decir 
NO con una instrucción SQL) 

selectCommand.CommandType = CommandType.StoredProcedure; 
t-ry 


// Establezca la conexión de la base de datos 
databaseConnection.Open(); 

// Ejecuta el comando SQL 

OleDb DataReader rowReader - selectCommand . Execut eReade r {'■) 

// Informe de los resultados 
while(rowReader.Read()) 

{ 

string contact.Name = 
rowReader [ " Cont actName " ] . ToStnng ( ) ; 

string contactTitle - 
rowReader [ "ContactTitle" ] .ToStnng () ; 

Consolé .WriteLine("Contact ñame is {0}, title is {1}.", 
cont actName , contactTitle) ; 


catch (Exception e) 

{ 

Consol e.WriteLine ("**•■*-*** Caught an exception: \n{ 0 }" , 
e.Message); 

} 

fmally 
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databaseConnection.Clo.se () ; 



El uso de un objeto DataSet para recuperar un conjunto de registros tam¬ 
bién le resultara familiar (véase el listado 23.9). De nuevo, todo lo que tiene que 
hacer es añadir una iteración para capturar todos los registros recuperados. Esto 
puede hacerse con un bucle for. como muestra el listado 23.1K. 

Listado 23.18. Cómo recuperar un conjunto de registros con DataSet. 

static void TestSelectManyWithDataSet(string customerID) 

{ 

// Establezca las cadenas de instrucción SQL 
string strSQLSelect = " [pc_getCustomers] "; 

// Cree objetos OleDb 

OleDbConnection databaseConnection = new 
OleDbConnection(oleDbConnectionString); 

OleDbCommand selectCommand = new OleDbCommand(strSQLSelect, 
databaseConnection); 

OleDbDataAdapter dsCmd = new OleDbDataAdapter(); 

DataSet resultDataSet = new DataSet(); 

// Estamos tratando con procedimientos almacenados (es decir, 
NO con una instrucción SQL) 

selectCommand.CommandType - CommandType.StoredProcedure; 

t ry 

{ 

// Establezca la conexión de la base de datos 
databaseConnection.Open () ; 

// Ejecute el comando SQL 

dsCmd.SelectCommand = selectCommand; 

int numRows = dsCmd.Fill(resultDataSet, "Customers "/> 

// Informe de los resultados 
íf (numRows > 0) 

{ 

// numRows = 

resultDataSet.Tables["Customers " ] .Rows.Count 
for (int i = Ü; i<= numRows - 1; i + + j 

{ 

string contactName 

= resultDataSet.Tables["Customers"J .Rows[i]["ContactName"J . 
ToString () ; 

string contactTitle 

= resultDataSet.Tables["Customers"].Rows[i]["ContactTitle"]. 
ToString(); 
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Consolé.WriteLine("Contact ñame is {0}, title is 
{!}.", contactName, contactTitle); 

} 

} 

e 1 s e 


Consolé . Wr .it eLine ( "No rows found!" ); 


catch (Exception e) 

{ 

Consolé.WriteLine("****** Caught an exception:\n{0}", 
e.Message) ; 

} 

fi nally 

{ 

databaseConnection.Cióse () ; 

} 


Operaciones de datos que afectan a conjuntos 
de filas 

Las operaciones de datos que afectan a conjuntos de filas siguen la misma 
estructura que las operaciones que afectan a las filas únicas. El listado 23. I c ) 
agrega dos nuevas filas antes de llamar al comando Update ( ) . Si lo compara¬ 
mos con el listado 23.10 no aparece ninguna diferencia, aparte de la obv ia adición 
del codigo que crea, da valor y agrega la segunda fila Debido a las similitudes 
entre el código para una fila única y el código para filas múltiples, esta sección no 
repetirá todos los ejemplos mostrados con anterioridad para las instrucciones que 
afectan a varias filas Update y Delete. 

Listado 23.19. Cómo agregar dos registros mediante un InsertCommand generado 

automáticamente 

static void TestAutoInser t2WithDataSet (string customerIDl, 
stnng cus tome r ID2) 

{ 

// Establezca las cadenas de instrucción SQL 

string strSQLSelect = "EXEC [pc_getCus t omer_ByCust orne rID] 
@Custorne rID _1 =' ? ? ?' " ; 

// Cree objetos OleDb 

OleDbConnection databaseConnection = new 
OleDbConnection(oleDbConnectionString); 

01eDbCommand selectCommand = new OleDbCommand(strSQLSelect, 
databaseConnection); 

OleDbDataAdapter dsCmd = new OleDbDataAdapter() ; 

// ¡i¡La siguiente linea es clave para generar instrucciones 
automáticamente! ! ! 
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OleDbCommandBuiJder custCB = new 01eDbCommandBui 1 der (dsCmd) ; 
DataSet resultDataSet - new DataSet f) ; 

// Estamos tratando con una instrucción SQL (es decir, NO con 
un procedimiento almacenado) 

selectCommand.CommandType = CommandType.Text ; 

try 

{ 

// Establezca la conexión de la base de datos 
databaseConnection.Open ( ) ; 

// Ejecute el comando SQL 

dsCmd.SelectCommand = selectCommand; 

infe numRows = dsCmd . Fi 1 1 (resul t Da t a Set , "Customers" i ; 

// Cree una nueva p rime r a fila 
DataRow workRow = 

res u 11D ataSet.Tables [ "Custorne es"] .NewRow (| ; 

// C omplete los datos workrow 

wo r k Row["Cus tome r T D"] = customerlDl; // 1 

wo r kRow [ " CompanyName " J = "Hungry Coyote FLxport Store"; 

// 2 

workRow["ContactName" | = "Yoshi Latimer"; // 3 

workRow["ContactTitle"] - "Sales Representativo"; // 4 

workRow [ "Address" ] = "City Center Plaza ble Mam St . "; 

// 5 

workRow["City" ] = "Elgin"; // 6 

workRow["Región"] - "OR"; // 7 

workRow["PostalCode"] - "97827"; // 8 

workRow["Country"j = "USA"; // 9 

workRow["Phone"] & "(503) 555-2874"; // 10 

wo r kRow["Fax"] = "(503) 555-2 372"; / / 1 J 

resultDataSet.Tables["Customers"] .Rows.Add(wor kRow) ; 

// Cree una nueva segunda linea 

workRow = resultDataSet.Tables["Customers"].NewRow(); 

// Complete los datos workrow 

workRow["CustomerID"] = customerID2; // 1 

workRow["CompanyName" ] - "Hungry Coyote Export Store"; 

// 2 

workRow["ContactName"] = "Yoshi Latimer"; // 3 

workRow["ContactTitle"] = "Sales Representativo"; // 4 

workRow["Address"] = "City Center Plaza 516 Main St."; 

// 5 

workRow["City" ] - "Elgin"; // 2 

workRow["Región"] = "OR"; // 7 

workRow["PostalCode"] - "97827"; // 8 

workRow["Country"] = "USA"; // 9 

workRow["Phone"] = "(503) 555-6874"; // 10 
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wor kRow [" Fax" ] 


(503) 555-2376"; 


// 11 


resultDataSet.Tables["Custorners"].Rows.Add(workRow); 

// Compat ibi 1 ice los cambios con la fuente de datos 
dsCmd.Update(resultDataSet, "Custorners"); 

// Informe de los resultados 

Consolé.WriteLine("Inserted 2 rows."); 

} 

catch (Exception e) 

{ 

Consolé.WriteLine("****** Caught an exception:\n{0}", 
e.Mes s age) ; 

} 

final 1 y 

{ 

databaseConnection.Cióse () ; 

) 


Operaciones que no devuelven datos 
jerárquicos 

Un aspecto poco conocido de ADO es que es posible recuperar varios conjun¬ 
tos de datos de una pasada. ADO.NET también dispone de esta característica. 
Observe los dos procedimientos almacenados consecutivos del procedimiento al¬ 
macenado en el listado 23.20. (De nuevo, el resultado se limita a cinco registros 
para cada uno. para realizar la prueba). 

Listado 23.20. Un procedimiento almacenado SQL Server con dos instrucciones 

Select 


USE [Northwind] 

GO 

CREATE PROCEDURE [pc_getOrdersAndDetai1s] 
AS 

SELECT TOP 5 
OrderID, 

Cus t orne rID, 

EmployeeID, 

OrderDate, 

RequiredDate, 

ShippedDate, 

ShipVia, 

Freíght, 

ShipName, 

ShipAddress, 

ShipCit y, 
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ShipRegion, 

ShipPostalCode, 

ShipCountry 
FROM Orders 

SELECT TOP 5 
OrderID, 

ProductID, 

Unit Price, 

Quantity, 

Discount 

FROM [Order Details] 

GO 

Para recuperar esto datos, emplee un DataReader de la misma forma que 
hizo para recuperar conjuntos de filas. Sin embargo, si compara el código del 
listado 23.21 con el código del listado 23.17. comprobará que hay un bucle adi¬ 
cional alrededor de la iteración de filas. Este bucle adicional termina cuando 
Next Results ( ) es False. Esto es lo que se debe saber para recuperar con¬ 
juntos de filas múltiples. 

Listado 23.21. Cómo recuperar varios conjuntos de datos con DataReader 

static void TestSelectHierWithDataReader () 

{ 

// Establezca las cadenas de instrucción SQL 
string strSQLSelect « "[pc_getOrdersAndDetails] 

// Cree objetos OleDb 

OleDbConnection databaseConnection - new 
OleDbConnection(oleDbConnectionString); 

OleDbCommand selectCommand = new OleDbCommand(strSQLSelect, 
databaseConnection); 

// Estamos tratando con procedimientos almacenados (es decir, 
NO con una instrucción SQL) 

selectCommand.CommandType = CommandType.StoredProcedure; 

t ry 

{ 

// Establezca la conexión de la base de datos 
databaseConnection.Open(); 

// Ejecute el comando SQL 

OleDbDataReader rowReader - selectCommand.ExecuteReader() ; 

// Informe de los resultados 
for (;;) 

{ 

while{rowReader.Read ( ) ) 

{ 

st ring row = ""; 
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for (int i=0; i<= rowReader.FieldCount - 1; i + +) 

{ 

row = row + rowReader[i] + ", 

} 

Consolé.WriteLine("Row is {0}", 
row.Substring(ü,row.Length -2 ) ) ; 

} 

if ( !rowReader.NextResult () ) 
break; 
el se 

Consolé.WriteLine("Next Results:"); 

} 

} 

catch fExoeption e) 

{ 

Consolé .WriteLine (” + *****• Caught an except ion : \n { 0 } " , 
e.Message); 

I 

f i n a 11 y 
{ 

databaseConnection.Cióse ( ) ; 


En la última sección del código está uno de los puntos fuertes del objeto 
Datañet: la recuperación de datos relacionados. Como el DataSet fue diseñado 
para trabajar como una base de datos en memoria, tiene toda la funcionalidad 
necesaria para tratar con las relaciones primarias y secundarias. Los siguientes 
dos listados ejemplifican la recuperación de datos. El listado 23.22 muestra cómo 
se recuperan datos relacionados mediante una instrucción SQL y el listado 23.23 
muestra cómo recuperar datos relacionados usando un objeto DataSet. El lista¬ 
do 23.23 demuestra como tratar con este tipo de relaciones. De nuevo, se usa un 
procedimiento almacenado que devuelve datos de dos instrucciones Select. Las 
instrucciones Se lect están relacionadas y se quiere conseguir el mismo resulta¬ 
do en ADO.NET como si se recuperasen los datos con una instrucción SQL igual 
a la que aparece en el listado 23.22. 

Listado 23.22. Cómo recuperar datos con instrucciones SQL 


SELECT 

Oiders.O rder1D, 
Qrders . Cus t orne r 1 p, 
ürders.Emp1o y eelD, 
Qrders.OrderDate, 

Or de r s.RequiredDate, 
Qrders.S hip p e d D ate, 
Qrders. S h i p V ia, 
Qrders . Freight. , 
Qrders.S hipN ame, 

Or de r s.ShipAddress, 
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Orders.ShipCity, 

Orde rs.S hipRe gion, 

Orders.ShipPostalCode, 

Orders.ShipCount ry, 

[Order Details] . ProductID, 

[Order Details] .UnitPnce, 

[Order Details].Quantity, 

[Order Details].Discount 
FROM Orders 

INNER JOIN [Order Details] 

ON Orders.OrderID = [Order Details].OrderID 

En la instrucción try del listado 23.23. se empieza asignando las tablas de 
datos a las tablas de origen usadas en la consulta SQL El codigo que le sigue, 
completando el DataSet. es el código habitual incluido más abajo. A continuación 
viene la parte en la que se define la relación entre las dos tablas. Al establecer las 
relaciones entre las claves externas en un sistema de gestión de bases de datos 
relaciónales (RDBMS) se necesitan las claves primarias y la base de datos en 
memoria no es diferente. La propiedad PrimaryKey recibe una matriz de obje¬ 
tos DataColumn. Tras establecer las claves primarias, se puede definir una 
relación. El primer parámetro es el nombre de la relación, que usara más tarde 
para recuperar los registros secundarios. A modo de demostración, el ejemplo 
recupera sólo la primera fila principal. A continuación recupera todas las filas 
secundarias asociadas mediante el método GetChildRows ( ) usando el nom¬ 
bre de la relación. A continuación se puede usar un bucle que recorra la matriz de 
objetos DataRow para mostrar las filas secundarias. 

Listado 23.23. Cómo recuperar datos relacionados con DataSet 

static void TestSelectHierWithDataSet ( ) 

í 

// Establezca las cadenas de instrucción SQL 
string strSQLSelect - " [pc_get.Orde r sAndDe t ai 1 s ] " ; 

// Cree objetos OleDb 

OleDbConnection databaseConnection - new 
OleDbConnection(oleDbConnectionSt ring) ; 

OleDbCommand se1ectCommand - new OleDbComimand(strSQLSelect, 
databaseConnection); 

OleDbDataAdapter dsCmd = new OleDbDataAdapter í) ; 

DataSet resultDataSet = new DataSet () ; 

// Estamos tratando con procedimientos almacenados (es decir, 
NO con una instrucción SQL) 

selectCommand.CommandType - CommandType.StoredProcedure; 

try 

{ 

dsCmd.TableMappings.Add("Orders", "Orders"); 

dsCmd . TableMappmgs . Add ( "Order s 1" , "Order Details") ; 
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// Establezca la conexión de la base de datos 
databaseConnection.Open () ; 

// Ejecute el comando SQL 

dsCmd.SelectCommand = selectCommand; 

// Como no hay tablas en el DataSet antes de invocar el 
método Fill, 

// el OleDbDataAdapter creará automáticamente las tablas 
para el DataSet 

// y las completará con los datos devueltos. Si crea las 
tablas antes de ejecutar 

// el método FillDataSet, el OleDbDataAdapter simplemente 
completará las tablas existentes. 

int numRows = dsCmd.Fill(resultDataSet, "Orders"); 

// Reduzca el numero de puntos evitando las referencias a 
las tablas 

DataTable orderTable = resultDataSet.Tables["Orders"]; 
DataTable detailsTable - resultDataSet.Tables["Order 
Details"] ; 

// Establezca la clave primaria de las tablas 
orderTable.PrimaryKey = 

new DataColumn[] { orderTable.Columns["OrderID"] }; 

detailsTable.PrimaryKey = new DataColumn[] { 

detailsTable.Column s ["OrderID"] , 
detailsTable.Columns["ProductID" ] } ; 

// Establezca la relación de clave externa entre las tablas 

resultDataSet.Relations.Add(new DataRelation{"Order_Detail", 
new DataColumn[] { 

orderTable.Columns["OrderID"] }, 

new DataColumn[] { 

detailsTable.Columns["OrderID"] 

})};■ 

// Informe de los resultados 
// Muestre el pedido 

DataRow orderRow - orderTable.Rows[0] ; 

Consolé.WriteLine("Order ID is {0}, date is {1}, Ship To 
ís {2}.", orderRow["OrderID"], 
orderRowf"OrderDate"], 
orderRow["ShipName"]); 

// Recupere las filas secundarias para el pedido usando el 
nombre de la relación 

DataRow[] detailRows - 
orderRow.GetChildRows("Order_Detai1"); 

// Hace algo con la colección de filas secundarias 
DataRow detaiIRow; 

for (int i=0; i <= detaiiRows.Length - 1; i++) 

{ 

// Hace algo con la fila detail 
detailRow = detailRows[i]; 

Consolé.WriteLine("Product ID is {0}, Quantity is 

{ 1 } - " , 


526 



detaiIRow["ProductID"], 
detailRow["Quantity" ] ) ; 

} 

} 

catch (Exception e) 

{ 

Consolé .WriteLine ("**** + * Caught an exception: \n-{ Ó} " , 
e.Message); 

} 

f mal ly 
{ 

databaseConnection.Cióse () ; 

} 


Resumen 

Este capítulo describe todos los tipos de operaciones que puede realizar en 
ADO.NET. También se muestra lo sencillos y versátiles que son los objetos en el 
espacio de nombres System. Data, incluyendo el potente objeto DataSet. 
que funciona como una base de datos en memoria. También describe cómo dev ol¬ 
ver filas con entidades únicas y cómo borrar y actualizar operaciones. 

Tenga en cuenta que la arquitectura de proveedor AD0.NET se refleja en las 
clases NET Framework que admiten AD0.NET. Podemos usar las clases Sql 
para aprovechar el proveedor SQL Server de ADO.NET. Si su aplicación sólo va 
a admitir SQL Server, debe usar las clases SQL, porque el proveedor SQL Server 
para ADO.NET es más eficiente y funciona mejor que el proveedor OLE DB 
cuando se trata de SQL Server. Si su aplicación necesita incluir compatibilidad 
con otras bases de datos que no son SQL Server, es aconsejable elegir clases 
OleDb. 
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Cómo trabajar 
con archivos 
con el registro 
de Windows 


Las operaciones de archivo son algo a lo que todo programador debe enfren¬ 
tarse en un momento u otro. La clase System. 10 contiene una cantidad ingente 
de métodos para leer y escribir en y desde archivos. Esta clase simplifica la E S 
de archivos y su manipulación y brinda un gran control de acceso a archivos. De 
forma parecida a la E/S del pasado, el acceso al registro de Windows siempre ha 
sido una tarea muy pesada. Esta tarea requería muchas llamadas al API que 
reducían el rendimiento de la aplicación y solían obligar al programador a escri¬ 
bir sus propias clases contenedoras para estas operaciones. Con NET todo esto 
cambio. En este capítulo aprenderá a leer y escribir datos en y desde archivos. El 
capítulo estudia las operaciones de E/S que operan con texto normal y con datos 
binarios. También estudia algunas operaciones de archivos útiles, como mover, 
renombrar y eliminar archivos. Por ultimo, aprenderá a supervisar el sistema de 
archivos para buscar cambios en archivos específicos y seguir recorriendo el 
registro de Windows. 

Cómo acceder a archivos 

El acceso a archivos en .NET suele hacerse con objetos de secuencia. Sin 
embargo, algunas clases confían en los objetos de secuencia para acceder a los 
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archivos. En este capítulo examinaremos dos de estas clases para mejorar su 
conocimiento de la E/S de archivos. 

Acceso binario 

Las clases BinaryReader y BinaryWriter son compatibles con el ac¬ 
ceso binario a archivos. Estas clases permiten el acceso a archivos binarios y las 
operaciones binarias hacia y desde secuencias. Como se usan secuencias, las 
clases pueden ser muy flexibles y no tienen que tratar con detalles, como la posi¬ 
ción de la secuencia o el acceso a la misma. El siguiente apartado examina la 
clase de acceso BinaryWriter. 

BinaryWriter 

La clase BinaryWriter permite escribir tipos de datos primitivos en se¬ 
cuencias y con el uso de las subclases, se pueden reemplazar los métodos de esta 
clase v cumplir con los requisitos de la codificación única de caracteres. Como 
esta clase usa una secuencia subyacente, hay que trabajar con muy pocos métodos 
v propiedades. La tabla 24.1 contiene las cinco propiedades y métodos básicos 
que más usara para trabajar con la clase BinaryWriter. 

Tabla 24.1. Miembros básicos de la clase BinaryWriter 


Nombre 

Tipo 

Función 

BaseStream 

Propiedad 

Permite el acceso a la secuencia subya¬ 
cente BinaryWriter 

Cióse 

Método 

Cierra la clase BinaryWriter y la se¬ 
cuencia subyacente, eliminando todas las 
operaciones de escritura pendientes. 

Flush 

Método 

Escribe todos los datos almacenados en 
el búfer en la secuencia subyacente y lue¬ 
go limpia los búferes. 

Seek 

Método 

Establece la posición actual dentro de la 
secuencia en uso. 

Write 

Método 

Este método sobrecargado escribe un va¬ 
lor en la secuencia en uso. Actualmente 
admite 18 variaciones de tipos de datos. 


Para escribir datos en un archivo, antes hay que crear una secuencia de archi¬ 
vos. Seguidamente se puede instanciar una nueva clase BinaryWriter. pasán¬ 
dola a la secuencia. Tras crear esta clase BinaryWriter. sólo hay que llamar 
a su método Write ( ) y pasarle los datos que se deben escribir, como se puede 
ver en el listado 24.1. 
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Listado 24.1. Cómo escribir datos en una secuencia de archivos mediante la clase 

BinaryWriter 

static void Main(string[] args) 

{ 

FileStream myFStream = new FileStream ("c: \\TestFile .dat", 
FileMode.OpenOrCreate, FileAccess.ReadWrite) ; 

BinaryWriter binWrit = new BinaryWriter(myFStream); 
string testString = M This is a test stnng. 
binWrit.Write(testString); 
binWrit.Cióse(); 
myFStream.Cióse() ; 


Al acabar con la clase BinaryWriter. hay que asegurarse de cerrarla y de 
cerrar la secuencia. Si no se cierra la clase BinaryWriter o la clase 
FileStream. se puede producir una pérdida de datos. 

BinaryReader 

La clase BinaryReader. al igual que la clase BinaryWriter. se basa 
en un objeto FileStream para acceder a los archivos. 

Para comprender la clase BinaryReader. examine la aplicación del listado 
24.2. que lee la información del título binario de un archivo de mapa de bits. A 
partir de la información de este título, se puede determinar el tamaño horizontal y 
vertical del archivo de imagen, además de su profundidad de color en bits. 

Listado 24.2. Aplicación BitmapSize 


using System; 
using System.10; 

namespace BitmapSize 

{ 

class Classl 

{ 

static void Main(string[ ] args) 

{ 

long bmpWidth = 0; 
long bmpHeight = 0; 
int bmpPlanes = 0; 
int bmpBitCount = 0; 

string [] cma = Environment . GetCommandLmeArgs () ; 

íf (cma.GetUpperBound(0 ) >- i) 

{ 

FileStream myFStream = new 
FileStream(cma[ 1 ] , Fi1eMode.Open,Fi1eAccess.Read); 

BinaryReader binRead = new BinaryReader (myFStream) ; 
binRead.BaseStream.Position=0xl2; 
bmpWidth = binRead.Readlnt32 () ; 
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bmpHeight^ binRead.Readlnt32 () ; 
bmpPlanes= binRead.Readlnt16 () ; 
bmpBitCount - binRead.Readlnt16 () ; 

Consolé.WriteLine ( " [{0}] {1}x{2 } {3}- 

bit",cma[1],bmpWidth,bmpHeight,bmpBitCount); 
binRead.Close () ; 
myFStream.Cióse(); 


} 

} 

Lo primero que se debe hacer en esta aplicación es declarar algunas variables 
para que contengan la información que se lee desde el archivo de mapa de bits y. 
a continuación, hay que almacenar todos los argumentos de línea de comandos en 
una matriz de cadenas. 

En el anterior ejemplo, se almacenan los argumentos de línea de comandos en 
una matriz de cadenas, porque uno de estos argumentos determina que archivo 
debe procesarse. 

El elemento uno de la matriz de cadenas debe contener el nombre del archivo 
que debe procesarse Tras determinar si existe un argumento de línea de coman¬ 
dos. se puede crear un objeto FileStream pasando el nombre del archivo y el 
modo que quiere usar para abrir el archivo, como se muestra a continuación: 

FileStream myFStream = new FileStream( cma[i ] , FileMode.Open, 

Fi 1e Acces s.Rea d) ; 

Al igual que la clase BinaryWriter. se crea el objeto BinaryReader y 
se pasa al objeto FileStream que se quiere usar. En este punto, ya esta prepa¬ 
rado para leer un archivo usando el modo binario. Tras examinar el diseño del 
archivo de mapa de bits, sabe que la información que quiere obtener empieza en la 
posición IX (posición hexadecimal 12) del archivo. Al usar el objeto de la clase 
Bina r'/Rende r BaseStream. se puede acceder directamente al objeto 
F i leSt roam. A partir de aquí, establece la propiedad Position del objeto a 
()x 12. que busca en el archivo, a la posición desde la que se quiere leer. 

C uando el puntero del archivo está en posición, hay que leer dos valores lonq 
desde el archivo, seguidos por dos valores enteros. Un valor long necesita cua¬ 
tro bytes. de modo que se usa el método Readlnt32 dos veces para recuperar 
los v alores. 

A continuación, se usa el método Readlnt 16 para recuperar los dos archi¬ 
vos enteros del archivo. Observe en la tabla 24.2 la lista de los métodos mas 
usados en la clase BinaryReader. 

Una vez que se ha recuperado la información del archivo, sólo queda mostrar 
los valores almacenados en la consola. Tras compilar esta aplicación, vaya a la 
v entana de consola y pruébela con una imagen de mapa de bits, como muestra la 
figura 24 1 
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Tabla 24.2. Métodos más usados dentro de la clase BinaryReader 


Método 

Descripción 

Cióse 

Cierra el objeto BinaryReader y la secuencia base 

PeekChar 

Lee el siguiente byte disponible de la secuencia pero 
no hace avanzar la posición del byte o del carácter 
en el archivo 

ReadBoolean 

Lee un valor booleano (True/False) de la secuen¬ 
cia 

ReadByte 

Lee un solo byte de la secuencia. También existe 
un método ReadBytes para especificar el número 
de bytes que se deben leer. 

ReadChar 

Lee un solo valor char de la secuencia. También 
existe un método Readchars para especificar el 
número de chars que se deben leer. 

Read 1 ntl 6 

Lee un valor entero (2 bytes) 

Readln32 

Lee un valor long (4 bytes) 

Readlnt64 

Lee un entero de ocho bytes con signo 


ca C:\WIINDOWS\System32\cmd.exe 

C:\>bitnapsize c:\testl.brip 
[c:\testl.bnp] 455x695 24-bit 

C: \> 





Id 


Figura 24.1. Al usar BinaryReader, puede observar el tamaño de la imagen de un 

archivo de mapa de bits 


Cómo supervisar los cambios de archivo 

La supervisión de los cambios de archivo con C# es cada vez mas fácil gra¬ 
cias al uso del objeto FileSystemWatcher . Este objeto permite observar un 
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archivo concreto, un grupo de archivos, un directorio o toda una unidad para 
buscar varios eventos, incluyendo los cambios de archivo, eliminaciones de ar¬ 
chivo. creaciones de archivo y cambios de nombre de archivos. 

Se empieza usando el objeto FileSystemWatcher en uno de estos dos 
modos. Se puede crear un objeto FileSystemWatcher usando código y lue¬ 
go creando métodos para controlar los diferentes eventos, o se puede usar el 
método mas sencillo. El cuadro de herramientas de la interfaz de desarrollo de 
Visual Studio NET también contiene un objeto FileSystemWatcher que se 
puede insertar en el proyecto haciendo doble clic sobre ella. 

Las aplicaciones, como Microsoft Word y Microsoft Excel, supervisan los 
archivos que se están usando por si se producen cambios en ellos desde fuera. A 
continuación aparecerá la opción de volver a abrir el archivo de modo que pueda 
observar todos los cambios que se han hecho en él. Para explorar las característi¬ 
cas del objeto FileSystemWatcher se construye una aplicación que supervi¬ 
sa todos los archivos de texto en la raíz de la unidad C: y muestra la información 
importante en la ventana de la aplicación. 

Cómo usar la supervisión de archivos 

Para empezar esta aplicación de ejemplo, abra una nueva aplicación de Windows 
C#. Tras abrir la ventana del nuevo proyecto, agregue dos botones y un cuadro de 
lista. Tras agregar los componentes a Forml. cambie los nombres de los botones 
a btnStart y btnStop. Cambie las propiedades Text de estos botones a 
Start v Stop, respectivamente. Ahora que los controles están en su sitio, coloque- 
los como se muestra en la figura 24.2. 



Figura 24.2. Arrastre y coloque controles en la interfaz File monitor 
como se muestra aquí 


Debe agregar otro objeto más al provecto; FileSystemWatcher. Selec¬ 
cione la ficha Componentes del cuadro de herramientas, como muestra la figu¬ 
ra 24.3. Haga doble clic en FileSystemWatcher para agregar una instancia 
de este objeto al provecto. 
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Figura 24.3. La ficha Componentes del cuadro de herramientas contiene el objeto 

FileSystemWatcher 


Seleccione el componente f ileSystemWatcher 1 situado inmediatamen¬ 
te debajo de Forml en el diseñador de formularios. La propiedad EnableRai- 
s ingEvents activa el objeto y le permite empezar a buscar e\ entos del sistema 
de archivos. Como tiene los botones Start y Stop para conseguirlo, debe asegu¬ 
rarse de que el objeto no se activa cuando se ejecuta la aplicación Cambie la 
propiedad EnableRaisingEvents a False. La propiedad Filter permi¬ 
te asignar una máscara de archivo o un archivo que se debe observar. Como 
queremos ver todos los archivos, escriba * . txt en la propiedad Filter. Por 
último, necesita definir la carpeta en la que quiere supervisar archivos. Escriba 
C : \ en la propiedad Path para asegurarse de que sólo examina los archivos que 
se encuentran en la raíz de la unidad C Se puede supervisar toda la unidad 
asignando a la propiedad IncludeSubdirectories el valor True pero es 
probable que esto reduzca el rendimiento del sistema. 

Haga doble clic en el botón Start en Forml y añada el codigo del listado 24.3 
al controlador de eventos Click. 


Listado 24.3. Evento clic del botón Start 


prívate void btnStart_Click(object sender, System.EventArgs e) 
{ 

fíleSystemWatcher 1 .EnableRaisingEvents = true; 
btnStop.Enabled - true; 
btnStart.Enabled - false; 

} 
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El anterior código asigna a la propiedad EnableRais ingEvents el valor 
True. lo que activa el objeto FileSystemWatcher. A continuación desactive 
el botón Start para que no se pueda volver a hacer clic en él y active el boton 

Stop 

Ahora debe agregar algo de codigo al boton Stop para desactivar 
Fi leSystemWatcher. Agregue el codigo del listado 24.4 al evento Click 
del botón Stop. 


Listado 24.4. Evento cüc del botón Stop 

p r i va t. e v o id btnf>top C 1 i c k i oh j cct sender , System. EventArgs e i 
í 

f i 1 cSyst emWat che r 1 . Enab i eRai s bfigSvent s = false; 

bt. nS t op . Enab 1 ed = false; 

b tn 3t ar f .Fna b1e d - true; 

} 

FileSyst emWatcher ya esta operativo, pero debe agregar los controladores 
de evento para capturar todos los eventos de archivo. Regrese al editor de formu¬ 
larios haciendo doble clic en Forml en el Explorador de soluciones y hacien¬ 
do clic en el objeto f i leSystemWatcher i . En la ventana Propiedades, 
haga clic en el icono Eventos de la barra de tareas. Al hacer clic en los eventos 
que aparecen en la ventana, aparecerá el editor de codigo para que pueda modifi¬ 
car esos controladores de eventos. El listado 24.5 contiene el codigo que debe 
introducir en los cuatro eventos. 

Listado 24.5. Controladores de eventos FileSystemWatcher 

prívate void fileSystemWatcherl_Deleted(ob]ect sender, 

3ystem.IO.Fi 1eSys temEventArgs e ) 

{ 

listBoxl.Items.Add( "[" + e.Name + "] Delecea" ); 

} 

prívate void f i leSystemWatcher l_Renamed (object: sender, 

3 ystem. IO . P. e n a me d E v e ntArgs e ) 

f 

1 i stRox 1 . Items .Add ( "[" + e.OldName + " ]. Renamed to " + 

e.Name i; 


prívate void fi 1eSystemWatcherl_Changed(object sender, 
3 ys t em. T O . F i 1. e3 y s t emEvent Ar gs e ) 

{ 

1 istRoxi * Items.Add( "[" + e.Name + "] Changed" ); 

} 

prívate void fileSyst.emWatcherl_Created (object sender, 
System.10.Fi1eSystemEventArgs e ) 

{ 

IiñtBox1 .Items.Add f + e.Name + "] Created") ; 

} 
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Estos controladores de eventos son bastante simples: solamente muestran un 
mensaje en el cuadro de lista cuando se produce una operación. Antes de compro¬ 
bar esta aplicación, es importante tener en cuenta algunas cosas, (orno puede ver 
en cada una de estas funciones, los eventos Chanqed. Created y Deloted 
muestran los mismos datos: por tanto, tienen la misma firma. Lo extraño aquí es 
el evento Re ñame d. Como tres de los cuatro ex entos pasan los mismos datos al 
procedimiento del evento, es posible usar un controlador de eventos que controle 
estos tres eventos, pero seguirá necesitando que un controlador distinto se haga 
cargo del evento Renamed. 

Pulse F5 para ejecutar el programa y empezar a examinarlo como se indica a 
continuación: 

1. Cuando el programa se abra, haga clic en el botón Start. La aplicación 
esta superv isando la raíz de la unidad C . buscando cambios en los archi¬ 
vos de texto. 

2. Abra el Explorador de Windows. Haga clic con el botón derecho en la 
ventana del explorador y seleccione Nuevo>Documento de texto para 
crear un nuevo documento. 

3. En el nuevo documento, observará una entrada en el cuadro de lista de su 
aplicación File Monitor que índica que se ha creado un archivo. Abra este 
nuevo archivo de texto, agregúele algo de texto y guárdelo. De nuevo, vera 
entradas en la ventana de registro de la aplieacion. 

4. Ahora intente renombrar el archiv o y borrarlo a continuación. Los resulta¬ 
dos deberían ser similares a los que aparecen en la figura 24.4 




jnew text document 

txtj Created 

[new text docurnent 

txt] Changed 

[new text document 

txt] Renamed to trian* txt 

[bnans.txtl üeleted 



Stop | | 




Figura 24.4. Su aplicación File monitor muestra la actividad del archivo 

en tiempo real 

Debe ser consciente de que el evento Changed puede desencadenarse va¬ 
rias veces, porque FileSystemWatcher está examinando varias caracterís¬ 
ticas del archivo. Si el tamaño del archivo cambia, se desencadena el evento 
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Changed. Si la fecha de modificación y la marca de hora del archivo cambian, 
el evento Changed se desencadena de nuevo y así sucesivamente. No se des¬ 
anime si un evento se desencadena más de una vez. Por lo general no es un 
problema de la aplicación sino una garantía de que se ha establecido el 

NotifyFilters correcto. 

Cómo codificar FileSystemWatcher 

Puede agregar un FileSystemWatcher a su proyecto de C# sin usar el 
cuadro de herramientas de Visual Studio. Para conseguirlo, agregue una declara¬ 
ción al objeto situado inmediatamente debajo de la declaración de la clase, como 
muestra el listado 24.6. 

Listado 24.6. Cómo agregar una instancia FileSystemWatcher a declaraciones 

de clase 

public class Forml : System.Windows.Forms.Form 

{ 

private FileSystemWatcher MyFileWatcher = new 
FileSystemWatcher(); 

Como está creando el control en tiempo de ejecución, no puede ir a la ventana 
Propiedades y asignar valores a las diferentes propiedades según sea necesario. 
En cambio, estas tareas se controlan desde dentro del evento Click del botón 
Start. Tras establecer las propiedades, como en el anterior ejemplo del listado 
24.6. debe crear controladores de eventos y dirigirlos a las funciones adecuadas. 
El listado 24.7 muestra el listado actualizado del evento Click del boton Start. 

Listado 24.7. Cómo crear declaraciones de controladores de eventos en el evento 

Click del botón Start 

prívate void btnStart_Click(object sender, System.EventArgs e) 

{ 

MyFi1eWatcher.Path = "c:\\"; 

MyFi leWatcher.Filter - " *.txt"; 

MyFileWatcher.IncludeSubdirectories = false; 

MyFileWatcher.EnableRaisingEvents = true; 

this . MyFi leWat che r . P.enamed += new 
System. IO. RenamedEventHandler ( thi s . MyFi 1 eWat che r P.enamed ); 

this.MyFileWatcher.Changed + = new 
System.IO.FiieSystemEventHandler( this.MyFi1eWatcher Changed ) ; 
btnStari.Enabled = false; 
btnStop.Enabled = true; 

1 


A continuación, agregue codigo al botón Stop y cree controladores de eventos 
para FileSystemWatcher. Los nombres de función para estos controladores 
de eventos deben coincidir con la declaración que coloco en el evento click de 
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los botones Start. El listado 24.8 contiene el evento Stop Click \ los 
controladores de evento para los eventos Changed y Renamed. 

Listado 24.8. Cómo crear controladores de evento para el objeto 

FileSystemWatche r 

prívate void btnStop Click(object sender, System.EventArgs e) 

{ 

MyFileWatcher.EnableRaisingEvents = false; 
btnStop.Enabled = false; 
btnStart.Enabled - true; 


prívate void MyFileWatcher_Changed (obgect sender, 
System.10.FileSystemEventArgs e) 

{ 

listBoxl.Items.Add ( " [ " + e.FullPath + " ] Changed ) , 

} 


prívate void MyFileWatcher_Renamed(object sender, 
System.10.RenamedEventArgs e) 

{ 

listBoxl.Items.Add("L" + e.OldName + "] renamed to 

e.Ñame); 

} 


Cómo manipular archivos 

La manipulación de archivos es un acceso a archivos que sólo manipula el 
archiv o v no los contenidos. La manipulación de archivos puede incluir la copia, 
borrado v traslado del archivo. Precisamente. NET proporciona una clase llama¬ 
da Fi le I nf o incluida en el espacio de nombres System. 10 para estas ope¬ 
raciones. Esta sección describe algunos de los métodos de manipulación v su 
modo de empleo. 

Cómo copiar archivos 

La clase Filelnfo contiene, entre otras cosas, un método paia copiai ai- 
chivos. Este método, CopyTo. esta sobrecargado y tiene dos variantes. La pri¬ 
mera simplemente recibe el nombre del archivo de destino. Si va existe un archivo 
con ese nombre, el método termina. La segunda variante recibe un nombre de 
archivo de destino v un v alor booleano que indica si los archiv os se pueden o no 
sobrescribir. Para mostrar el método CopyTo. esta sección le muestra como 
construir una aplicación de consola para copiar archivos. Como Windows ya 
tiene un comando de copia, asigne al nuevo método el nombre cp. que es el 
comando de copia para UNIX. El listado 24.9 muestra la implementación com¬ 
pleta del comando Copy en C#. Cree una nueva aplicación de consola de C# 
llamada cp e introduzca el siguiente código. 
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Listado 24.9. Implementación C# del comando File Copy 


using System; 
using System.10; 
ñamespace cp 
{ 

c 1 a s s C 1 a s s 1 
{ 

static v o i d Mam (strmg [ ] a r g s ) 

{ 

string [] cl.a = Envi ronment .GetCommandLineArgs () ; 
íf (c1a.GetUpperBound(U) -= 2 ) 

{ 

F i ! e I n f o f i - new F i 1 e I n f o ( c 1 a [ 1 ] ) ; 
fi .CopyTo ( c1 a [ 2 ] ,trué) ; 

Conso le.WriteLine ( "Copied " + fi.Length 4 " bytes." ) ; 

} 

o 1 s e 

C onsoie .WriteLme í " U s a g e : cp < i npu t file > < ou t. p u t 



Este codigo usa el método GetCommandLineArgs de la clase 
Environment para recuperar los argumentos de línea de comandos que se 
pasan a la aplicación. Si el numero de argumentos no es igual a 2. simplemente 
muestra un mensaje de uso. como se puede ver en la parte inferior del listado 24.9 
v sale. En caso contrario, los argumentos de la linea de comandos se almacenan 
en la matriz de cadenas cía para ser usados más tarde. 

Al usar la clase Filelnfo. debe crear en primer lugar un objeto Filelnfo 
v pasarle el nombre del archiv o con el que está trabajando. Al usar esta aplica¬ 
ción. el argumento de la primera línea de comandos es el nombre del archivo 
fuente Como esto se almacena en el elemento I de la matriz de cadenas, simple¬ 
mente páselo al objeto Filelnfo. 

Para copiar un archivo usando esta clase, simplemente llame a su método 
CopyTo junto con el nombre del archiv o de destino (que está en el elemento 2 de 
la matriz de cadenas) y un v alor booleano que indique si se debe sobrescribir un 
archivo con el mismo nombre. Abra el intérprete de comandos para probar este 
programa después de compilarlo, como muestra la figura 24.5. 

Como puede ver. agregó algo inesperado al programa. Una v ez que el método 
CopyTo se haya completado, se muestra un mensaje en la consola que indica que 
la operación ha concluido y se muestra el número de bytes que se han copiado, 
gracias a la propiedad Length de la clase Filelnfo. 

Cómo eliminar archivos 

El proceso de eliminación de archivos con la clase Filelnfo resulta tan 
sencillo como llamar al método Delete ( ) . Si el archivo que quiere eliminar 
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tiene un valor en su atributo Read-Only. obtendrá una excepción. El ejemplo 
del listado 24 10 crea una implementación de C# del comando Delete del ar¬ 
chivo. Después de borrar el archivo, la utilidad muestra el nombre del archivo 
eliminado y sus atributos. 



Figura 24.5. CopyTo permite copiar un archivo y mostrar información adicional 


Cree un nuevo provecto de aplicación de consola de C # llamad rm e introduz¬ 
ca el código del listado 24.10. 

Listado 24.10. Uso de la clase Filelnf o para eliminar archivos fácilmente 

using System; 
using System.10; 
namespace rm 
{ 

class Classl 

{ 

static void Main(string[] args) 

{ 

string [] cía = Environment.GetCommandLineArgs(); 
if ( cía.GetUpperBound(0) = = 1) 

{ 

Filelnfo fi = new Filelnfo(cía[1] ) ; 
fi.Delete(); 

Consolé.WriteLine("File : " + c1a [ 1 ]) ; 

Consolé.WriteLine("Attributes: " + 
fi.Attributes.ToString() ) ; 

Consolé.WriteLine("File Deleted..."); 

} 

else 

Consolé.WriteLine ("Usage: rm <fi1ename>"); 



} 





Como en los anteriores ejemplos, esta almacenando los argumentos de línea 
de comandos dentro de una matriz de cadenas. Si esa matriz no contiene el nume¬ 
ro correcto de elementos, solamente se mostrará un mensaje de uso y finalizará. 



Tras invocar al método Dele te ( ) de la clase Filelnfo, puede mostrar al 
usuario el nombre del archivo y sus atributos, indicando que ha sido eliminado. 
Mediante la propiedad Attributes. puede determinar de un modo seguro, 
antes de eliminar el archivo, si tiene asignado su atributo Read-Only. En ese 
caso, puede avisar al usuario y/o eliminar el atributo Read-Only usando la 
propiedad Attributes junto con el enumerador FileAttributes. 

Una vez que su programa haya sido compilado, abra un intérprete de coman¬ 
dos y pruébelo. Simplemente escriba rm seguido del nombre del archivo que 
quiere eliminar. Los resultados deberían ser similares a los de la figura 24.6. 


C V C;\ WlfHDQW5\5ystem32\cmd.exe 

C:\>rn TenpFile.dat 
File : TenpFile.dat 

Attributes: Archive 
File Deleted... 


-Jai * 


Id 


Figura 24.6. El método Deletef) de la clase Filelnfo muestra los atributos del archivo 

eliminado 


Cómo trasladar archivos 

El método MoveTo ( ) de la clase Filelnfo en realidad encapsula dos mé¬ 
todos diferentes: CopyTo ( ) y Delete ( ) . Después de copiar un archivo en el 
nombre de archivo o directorio adecuado. MoveTo ( ) simplemente elimina el 
archivo de forma muy parecida a cómo lo hace el método Delete ( ) . 

El siguiente ejemplo de aplicación admite dos argumentos de línea de coman¬ 
dos: Source Filename y Destination Filename. Tras trasladar el 
archivo, el programa muestra cuando se creó en realidad el archivo y a donde se 
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trasladó. Ninguna de estas indicaciones tiene un uso practico, excepto para mos¬ 
trar cómo se pueden obtener algunos atributos, como la hora en que se creó el 
archivo, mediante la propiedad CreationTime. 

Cree una nueva aplicación de consola C# y llame al proyecto mv. como el 
comando de UNIX. El listado 24.1 1 muestra por completo la aplicación. 

Listado 24.11. Implementación de File Move 

using System; 
using System.10; 
namespace mv 
{ 

class Cíassi 
{ 

static void Main (string [ ] args) 

{ 

string [] cía =? Envi r onment. GetCommandLineAr gs () ; 
if (cía.GetUpperBound(O) == 2) 

{ 

FileInfo fi = new Filelnfo(cía[1]); 
fi.MoveTo (cía [ 2] ) ; 

Consolé.WriteLme ("File Created : " + 

fi.CreationTime.ToString()); 

Consolé.WriteLine("Moved to : " + cía [2]) ; 

} 

e 1 s e 

Consolé.WriteLine ("Usage: mv <source file> 
<destination file>"); 

} 

} 

} 


La figura 24.7 muestra el resultado de la utilidad File Move 



Figura 24.7. Mueva archivos con el método MoveTo de la clase Filelnf o 





Observo que en este ejemplo, el nombre del archivo de destino puede ser un 
nombre de archivo o un nombre de directorio. Si se especifica un nombre de 
directorio, el archivo se traslada. Si hay un nombre de archivo, el archivo es 
renombrado y/o trasladado. El método MoveTo ( ) básicamente incorpora las 
funciones de copia y renombrado en un método. 

Cómo acceder al registro 


El acceso al Registro era una tarea bastante pesada en el API de Windows. C# 
proporciona algunos objetos de clase que permiten leer y escribir en y desde el 
registro fácilmente. El uso del registro tiene varias ventajas sobre los antiguos 
métodos, como archivos INI con formato texto. Como el registro está indizado. la 
búsqueda de clav es se realiza rápidamente. El registro es un "documento" estruc¬ 
turado. lo que permite que la información estructurada, como una base de datos, 
sólo tenga que nombrar un tipo. 

Cómo leer claves del registro 

El acceso a la funcionalidad del registro se incluye en el espacio de nombres 
Microsoft. Win32. asi que tenemos que incluir este espacio de nombres en 
todos los proyectos introduciendo la siguiente línea en la parte superior del archi¬ 
vo de código fuente: 

using Microsoft.Win32 ; 

Para leer una clave del registro use el objeto RegistryKey. Para empezar a 
estudiar este objeto, examine el listado 24.12. una aplicación que recupera dos 
fragmentos de información del registro. 

Listado 24.12. Recupera el tipo de CPU y su velocidad del Registro 

using System; 

using Microsoft.Win32; 

namespace CPUInfo 

{ 

c 1 a s s C1 a s s 1 
{ 

static void Main(string[ ] args) 

{ 

RegistryKey RegKey = Registry.LocalMachine; 

RegKey = RegKey.OpenSubKey( 

"HARDWARE\ \DESCRI PTION\\System\\CentralProcessor\\0" ) ; 

Object cpuSpeed = RegKey.GetValue(" ~MHz ") ; 

Object cpuType = RegKey.GetValue("VendorIdentifier" ) ; 

Consolé .WnteLine ("You have a {0} running at {1} 


544 



MHz.",cpuType,cpuSpeed); 



Al instanciar una instancia de RegistryKey. hace que su valor sea igual a 
un miembro de la clase Registry. El anterior ejemplo asigna al objeto 
RegistryKey el valor del campo Registry. Lo calMa chine, que permite 
el acceso a la clave base HKEY_LOCAL_MACHINE . La tabla 24.3 tiene una lista 
de todos los campos públicos de la clase de registro. 

Tras establecer el objeto RegistryKey. invoque a su método 
OpenSubKey ( ) v proporcione la clave que quiere abrir En este caso concre¬ 
to, debe dirigirse a la clave HKEY_LOCAL_MACH INE \ HARDWARE \ 
DESCRIPTION\System\Central \ Processor \0\ y leer dos valores de 
esa clave. Tenga en cuenta que debe incluir dos barras invertidas en la cadena 
para que no sean confundidas con un signo de escape. 

Tras abrir la subclave, use las siguientes dos líneas de codigo para recuperar 
los valores "-MHz" y M VendorIdentif ier" de esa subclave: 

Object cpuSpeed = RegKey.GetValue("~MHz"); 

Object cpuType - RegKey.GetValue("Vendorldentifier"); 

Ahora tiene los valores almacenados en las variables adecuadas, de modo que 
puede mostrar la información en la ventana. Examine el programa desde una 
v entana de consola, como muestra la figura 24.8. 

Tabla 24.3. Campos públicos de la clase Registry 


Campo 


ClassesRoot 

CurrentConfig 

CurrentUser 

DynData 

LocalMachine 


Descripción 


ClassesRoot define los tipos de documentos y 
las propiedades asociadas a esos tipos. Este cam¬ 
po empieza en la clave hkey_classes_root del 
registro de Windows. 

CurrentConfig contiene información relativa al 
hardware de su equipo. Este campo empieza en la 
clave hkey_current_config del registro de 
Windows. 

Aquí se almacenan todas las preferencias del ac¬ 
tual usuario. Este campo empieza en la clave 
hkey_current_user del registro de Windows. 

DynData. 

LocalMachine contiene información para el equi¬ 
po. Este campo empieza en la clave hkey_local_ 
machine del registro de Windows. 
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Campo 

Descripción 

PerformanceData 

La clave base almacena información relativa al rendi¬ 
miento de los diferentes componentes de software. 
Este campo empieza en la clave hkey performan¬ 
ce data del Registro de Windows. 

Users 

Esta clave base contiene información para la confi¬ 
guración de usuario por defecto. Este campo empie¬ 
za en la clave hkey users del registro de Windows. 



Figura 24.8. La clase RegistryKey simplifica la lectura de la importante 
información del registro 


Si se esta trabajando en equipos con varios procesadores puede obtener una 
lista de todos los procesadores enumerando la clave Cent ralProcessor . Hay 
una subclave en Cent ralProcessor para cada CPU del equipo. 

Cómo escribir claves de registro 

Crear \ escribir claves en el Registro también se consigue usando el objeto 
RegistryKey. Varios métodos de la clase RegistryKey son útiles para 
escribir claves. La tabla 24 4 describe la función de algunos de los miembros mas 
importantes. 

ADVERTENCIA: Escribir valores puede ser peligroso y puede hacer que 
su sistema no responda si no se tiene suficiente cuidado. Compruebe dos 
veces todo el código antes de probar cualquier aplicación que escriba valo¬ 
res en el Registro. 










Tabla 24.4. Miembros comunes de RegistryKey 


Nombre 

Tipo 

Descripción 

SubKeyCount 

Propiedad 

Esta propiedad recupera un recuento de las 
subclaves de la clave actual. 

ValueCount 

Propiedad 

Esta propiedad recupera un recuento del 
número de valores de la clave actual. 

Cióse 

Método 

Este método cierra la clave actual. Si se 
han realizado cambios en la clave, los 
cambios se guardan en el disco. 

CreateSubKey 

Método 

Este método crea una nueva subclave o 
abre la subclave si ya existe. 

DeleteSubKey 

Método 

Este método elimina una subclave. Este 
método está sobrecargado y contiene un 
parámetro booleano que permite que se 
inicie una excepción si no se puede en¬ 
contrar la clave. 

DeleteSubKeyTree 

Método 

Este método elimina una clave y todas 
las subclaves secundarias de manera re¬ 
currente. 

DeleteValue 

Método 

Este método elimina un valor de una cla¬ 
ve. Este método está sobrecargado y con¬ 
tiene un parámetro booleano que permite 
que se inicie una excepción si no se pue¬ 
de encontrar el valor. 

GetSubKeyNames 

Método 

Este método devuelve una matriz de ca¬ 
denas que contiene todos los nombres de 
las subclaves. 

GetValue 

Método 

Este método devuelve un valor para una 
clave específica. Este método está so¬ 
brecargado y contiene un parámetro que 
admite un valor por defecto. Si no se pue¬ 
de encontrar el valor para la clave, se 
devuelve el valor por defecto que se es¬ 
pecificó. 

GetValueNames 

Método 

Este método devuelve una matriz de ca¬ 
denas que contiene todos los valores para 
la clave especificada. 

OpenSubKey 

Método 

Este método abre una subclave para un 
proceso (acceso de lectura y escritura). 

SetValue 

Método 

Este método asigna un valor a una clave. 
Para asignar el valor por defecto a una 
clave, asigne el parámetro subKey a una 
cadena vacía. 
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El listado 24.13 muestra una sencilla aplicación que escribe dos valores en el 
Registro y a continuación lee esos valores para mostrarlos. 

Listado 24.13. Cómo escribir texto y un valor DWord en el Registro 

u sin g System; 

using Microsoft .Wm32 ; 

namespace WriteRegValúes 

{ 

class C1a ss1 

{ 

static void Main(string[ ] args) 

{ 

RegistryKey RegKeyWrite = Registry.CurrentUser; 

RegKeyWrit e = RegKeyWrite.CreateSubKey 
("Software\\CSHARP\\WriteRegistryValue"); 

RegKeyWrite.SetValue("Success" , "TRUE") ; 

RegKeyWrite.SetValue("AttemptNumber",1); 

RegKeyWrite.Cióse () ; 

Regis t ryKey RegKeyRead = Registry.CurrentUser; 

RegKeyRead = RegKeyRead.OpenSubKey 
( " Software \ \ C SHARP \ \Wr i t eRegi s t r yValue ,f ) ; 

Object regSuccessful = RegKeyRead.GetValue ( "Success ") ; 
Object r egAttemptNumber == 

RegKeyRead.GetValue("AttemptNumber"); 

RegKeyRead.Cióse(); 

íf ( (string) regSuccessful == "TRUE") 

Consolé.WriteLine("Succeeded on attempt # 

{ 0 } " ,regAtt empt Numbe r) ; 
e .1 s e 

Consolé .WriteLme ("Failed! ") ; 



Tras crear un objeto RegistryKey. puede crear una nueva subclave con el 
método CreateSubKey ( ) . Asegúrese de emplear dos barras invertidas al usar 
este método para que el compilador no confunda los caracteres con una secuencia 
de escape. En este ejemplo, se crea una nueva clave bajo HKEY_CURRENT_USER. 
Almacene los valores en la subclave \Software\CSHARP\Write- 
RegistryValue. Una vez que la nueva clave esté en su sitio, use el método 
SetValue ( ) para especificar el nombre del valor y el valor actual Este ejem¬ 
plo almacena texto en el valor Success y un DWord en el valor 
AttemptNumber. Una vez asignados los valores, es aconsejable cerrar la clave 
por si se produce un corte de luz o algún fallo similar. En este punto, se han 
producido cambios en el registro. Si abre la aplicación RegEdit y se dirige a la 
clave adecuada, debería ver los valores mostrados en la figura 24.9. 
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Figura 24.10. Las claves que se leen de la consola se muestran en la consola 

Esta aplicación muestra una sencilla técnica para escribir valores en el regis¬ 
tro. Este método ha demostrado ser útil para controlar la configuración de los 
programas, guardar la última posición y tamaño de la interfaz de las aplicaciones 
y acciones similares. Las posibilidades son ilimitadas. 


Cómo enumerar claves del registro 


La enumeración de claves de Registro es muy parecida a la utilidad Buscar 
archivo de Windows: permite buscar en el registro desde cualquiera de sus puntos 
















V recuperar todas las subclaves y valores debajo de ese punto inicial. Actualmen¬ 
te no hav ningún método en ,NET para enumerar las claves de registro. Deberá 
crear sus propias funciones si las necesita. El conocimiento de la estructura de 
las claves que se desean enumerar hace que la tarea resulte mucho más sencillo, 
ya que puede usar un simple bucle. Si no se conoce la estructura de las entradas 
del registro, necesitará crear una función que pueda llamar y pasar la clave ini¬ 
cial cada vez que es invocada. 

El listado 24.14 es un ejemplo de enumeración de claves de registro. Este 
ejemplo inspecciona el registro en busca de una lista de todo el software que tiene 
instalado en su equipo. Este programa enumera cualquier aplicación que aparece 
en la sección Agregar o quitar programas del Panel de control. 

Listado 24.14. Cómo enumerar claves de Registro 


using System; 

using Microsoft.Win32 ; 

namespace Installed 
{ 

class Classi 

í 

static void Main(string[ ] args) 

{ 

Regis t ryKey myRegKey=Registry.LocalMachine; 
myRegKey^myRegKey.OpenSubKey 

( " SOFTWARE WMicr osof t \ \Windows WCurrentVersión \\Unins tal 1 " ) ; 
String [] subkeyNames = myRegKey.GetSubKeyNames(); 
foreach {String s in subkeyNames) 

{ 

RegistryKey UninstallKey=Registry.LocaIMachine; 

UninstallKey=UninstallKey.OpenSubKey 
( " SOFTWARE\\Mic ros of t WWindows \\Curr entVersion\ \Unins tal 1\\" + 

s) ; 

t ry 
{ 

Obj ect 

oValue=UninstalIKey.GetValue("Disp1ayName"); 

Consolé.WriteLine(oValue.ToString()); 

} 

catch (NullReferenceException) 


} 


} 


Tras crear un objeto RegistryKey. abra la subclave Uninstall. que 
contiene una lista de todos los programas instalados. A partir de aqui. use 
GetSubKeyNames. que devuelve una matriz de cadenas de todas las subclaves. 
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Ahora que tiene una lista de subclaves, use el operador foreach para recorrer 
todos los elementos de la matriz de cadenas de subclave. 

Al recorrer cada clave, se busca un v alor llamado DisplayName. Este va¬ 
lor es el nombre que se muestra en la sección Agregar o quitar programas del 
Panel de control. Recuerde que no todas las claves tendrán este valor. Por 
tanto, debe encapsular el método GetValue con una instrucción try . . cat ch 
para capturar todas las posibles excepciones. Cuando se encuentra un valor 
DisplayName. se recupera el valor y se muestra en la ventana. A continua¬ 
ción. la instrucción foreach pasa a la siguiente clave de registro de la matriz de 
cadenas. 

Pulse F5 para probar la aplicación. Probablemente vera una larga lista de 
aplicaciones desplazándose a medida que el programa inspecciona el registro 
(véase la figura 24.1 1). 

Una cosa que no se intenta en este programa es ordenar las aplicaciones 
alfabéticamente. Los elementos del registro no se almacenan así. pero para solu¬ 
cionar esto, puede simplemente almacenar los resultados en una matriz de cade¬ 
nas v llamar al método Sort para ordenar el resultado de la manera deseada. 


cC C:\WINDOWS\Systevn32\cmd.exe 

AUerTU 

Microsoft Uisual Studio .NET Enterprise Architect - Español 
WinAce Archivar 2.0 
Winamp (renoue only> 

Microsoft Windows Script Host 
Win ISO 5.3 
Compresor WinRAR 
WinZip 

Uisual Studio .NET Enterprise Architect - Spanish 

Biblioteca de Consulta Microsoft Encarta 2002 

Microsoft .NET Franework <Spanish> vi.0.3705 

EA.com Matchup 

WebFldrs XP 

Adobe Illustrator 10 

Uisual Studio.NET Baseline - Spanish 
PowerDUD 

NeverwÍnter Nights 
McAfee UirusScan 

Microsoft Office XP Professional con FrontPage 

EA.com Update 

FilterSDK 

QuarkXPress Passport 

Microsoft FrontPage Client - Spanish 
C:\> 




Figura 24.11. Cómo inspeccionar todas las aplicaciones instaladas 
con un enumerador de Registro 


Resumen 


.NET Framevvork ha reducido enormemente la cantidad de código y tiempo 
necesario para tratar efectivamente con archivos y con el registro de Windows. 
Entre los muchos beneficios de NET Framevvork. ahora tiene acceso a compo¬ 
nentes como FileSystemWatcher que permite examinar un sistema de archi¬ 
vos para buscar cambios realizados en cualquier archivo. Sin embargo, debe tener 
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cuidado al escribir aplicaciones que traten con el registro de Windows, porque si 
elimina por error claves de registro puede hacer que su sistema se vuelva inesta¬ 
ble o incluso que deje de funcionar. 
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Cómo 


acceder 


a secuencias 
de datos 


.NET Framcwork tiene clases que proporcionan un gran nivel de compatibili¬ 
dad para la lectura y escritura de datos. Tradicionalmentc. los lenguajes han 
proporcionado compatibilidad integrada para la lectura y escritura de archivos de 
disco y han confiado en las interfaces de programación de los sistemas operativos 
para la lectura y escritura de otros tipos de secuencias de datos, como conexiones 
de red o archivos de memoria. NET Framcwork unifica la E/S de datos al propor¬ 
cionar un conjunto de clases común que admite lecturas y escrituras de datos sin 
importar el sistema de almacenamiento subyacente usado para proporcionar el 
acceso a los datos. Todas estas clase pueden usarse desde el eodigo C#. 

En este capítulo aprenderá a usar secuencias. Aprenderá a usar lectores y 
escritores para leer y escribir datos en una secuencia y a realizar operaciones de 
archivo en segundo plano. 

Jerarquía de clases de E/S de datos 

La figura 25.1 muestra la jerarquía de clases para las clases básicas NET 
Framcwork que se emplean al trabajar con E/S de datos. Las clases se agrupan en 
una de estas tres categorías: secuencias, escritores y lectores. 





Figura 25.1. Jerarquía de clases de E/S de datos 

Cómo usar secuencias 

Las clases de secuencia proporcionan un mecanismo para hacer referencia a 
un contenedor de datos. Las clases de secuencia comparten una clase base común 
llamada Stream. que está definida en un espacio de nombres NET Framework 
llamado System.10. 
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La clase base Stream contiene propiedades y métodos que permiten a los 
¡mocadores trabajar con la secuencia de datos. NET Framework dispone de 
varias clases que se derivan de la clase base Stream. Cada clase proporciona 
una implementación especifica de una secuencia de datos usada para un entorno 
particular. 

La clase FileStream. por ejemplo, proporciona una implementacion que 
permite a los ¡mocadores trabajar con secuencias de datos vinculadas a un archi¬ 
vo de disco. 

Del mismo modo, la clase Networ kStream proporciona una implementación 
que permite a los mvocadores trabajar con secuencias de datos a las que se accede 
mediante una red de comunicaciones. 

Cómo usar escritores 


Las secuencias admiten el acceso de datos en el nivel de bvte. Incluyen mé¬ 
todos llamados Read ( ) y Write ( ) . que trabajan con una matriz de bytes que 
se procesan durante la llamada. Sin embargo, trabajar a nivel de bvte puede no 
ser lo mejor para una aplicación. Suponga, por ejemplo, que una aplicación debe 
escribir una serie de números enteros en una secuencia. Como los números ente¬ 
ros en la implementación de 32 bits tienen un tamaño de cuatro bytes. el codigo 
C# necesitará convertir cada número entero en una cadena de cuatro bytes que 
pueda ser usada en una llamada a la implementación de Write ( ) de la secuen¬ 
cia. .NET Framework incluye clases de escritor que permiten escribir varios 
tipos de datos de nivel superior en una secuencia. 

Un escritor puede admitir muchas sobrecargas de un método Write ( ) . Por 
ejemplo, un escritor puede aceptar datos como int. long o double. Las 
implemcntacioncs de la clase writer convierten los tipos de datos en una serie 
de bytes y pasan esa secuencia de bytes convertidos a un objeto Stream. Este 
diseño de clase libera al código de tener que trabajar con secuencias de nivel de 
bv te. El código de la aplicación de C# puede simplemente indicar, por ejemplo, 
"escribe este dato long sin signo en la secuencia" y permitir que la clase writer 
realice el trabajo necesario para obtener el valor almacenado en la secuencia 
como una serie de bytes. 

Cómo usar lectores 

Las clases de lectores complementan a las clase de escritores. Como las clases 
de escritores, las clases de lectores admiten la lectura de tipos de datos que va mas 
alia de la simple matriz de bytes admitida por las clases de secuencia. En NET 
Framework. hay una clase de lector para complementar a cada clase de escritor. 
Las clases de lector proporcionan varias sobrecargas de un método Rea d ( ) que 
permite que el código de una aplicación lea varios tipos de datos, como cadenas, 
enteros, long. etc. 
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Cómo trabajar con secuencias 


Las secuencias admiten dos métodos de E/S: 

• E/S sincrónica* en la que las llamadas que realizan la secuencia de E/S no 
regresan al invocador hasta que la operación de E/S solicitada se ha com¬ 
pletado. 

• E/S asincrónica, en la que las llamadas que realizan la secuencia de E/S 
regresan al invocador antes de que la operación de E/S solicitada se haya 
completado v. posteriormente, informa al invocador de la conclusión de la 
operación. 

E/S sincrónica 

El listado 25.1 muestra una E/S de secuencia sincrónica. Crea un archivo y 
escribe 256 bvtes de datos binarios en él. A continuación, lee los 256 bvtes del 
archivo v se asegura de que la lectura de datos coincida con los datos escritos. 

Listado 25.1. E/S de archivos sincrónica 


using System; 
using System.10; 

cías s FileTestClass 
{ 

prívate FileStream BinaryFile; 
prívate byte [] ByteArray; 

í 

BinaryFile = new FileStream("test.dat", FileMode.Create, 
FileAccess . ReaclWrite) ; 

ByteArray = new byte [256]; 

} 

public v o i d WriteByt.es (í 
{ 

int ArrayIndex; 

for íAr r ayIndex = 0; Arraylndex < 256 ; Arraylndex++) 

ByteArray [Arr ay Index], = (byte) Arraylndex; 

BinaryFile.Write(ByteArray, 0, 25 6); 

} 


public bool ReadBytes() 
( 

int Arraylndex; 
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BinaryFile.Seek ( O, SeekOrigin.Begin) ; 

BmaryFile . Read (ByteArray, 0, 256); 

f or (Arr ay Index = 0; Arr ay Index < 2 56 ; Arraylnde>:+ + ) 

{ 

íf(ByteArray[Arraylndex] != (byte)ArrayIndex) 

return false; 

} 

return t rué; 


class MainClass 
{ 

static publíc void Main() 

{ 

FilelestClass FileTest = new Fj 1eTestClass f ) ; 
bool ReadTest; 

FileTest.WriteBytes()| 

ReadTest = FileTest.ReadBytes (1 ; 
íf(ReadTest == true) 

Consolé.WriteLine("The readback test was successful. 
e 1 s e 

Consolé.WriteLine ( "The readback test failed."! ; 


) 

El listado 25.1 implemcnta dos clases C#: Fi 1 eTestClass. que contiene el 
código de E/S de la secuencia y MainClass. que contiene el método Main ( ) 
de la aplicación. El método Mal n () crea un objeto de la clase F i leTestCiass 
y pide al objeto que escriba y lea datos. 

La clase FiieTesteiass contiene un miembro privado que representa un 
objeto Fi 1 eStream. El constructor de la clase crea un nuevo objeto 
FiicStream mediante un constructor que acepta tres argumentos: 

• La ruta de la secuencia de archivo con la que se va a trabajar. 

• Una especificación de modo para la operación de archivos. 

• Una especificación de modo para el acceso a archivos. 

La especificación de modo para la operación de archivos esta representada por 
una enumeración llamada Fi leMode. La enumeración FileMode se incluye 
en el espaeio de nombres System. 10 de .NET y admite los siguientes miembros 
de enumeración: 

• Append. que ordena a la secuencia de archivos que abra el archivo indi¬ 
cado si lo encuentra. Si el archivo indicado existe. la clase de secuencia de 
archivos se inicializa para escribir datos al final del archivo. Si el archivo 
indicado no existe, la clase crea un nuevo archivo con el nombre especifi¬ 
cado. 
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• Create. que ordena a la secuencia de archivos que cree el archivo indica¬ 
do. Si el archivo ya existe, se sobrescribe. 

• CreateNew. que. como Create. ordena a la secuencia de archivos que 
cree el archivo indicado. La diferencia entre CreateNew y Create es el 
modo de trabajar con los archivos existentes. Si el archivo ya existe cuan¬ 
do se especifica CreateNew como modo de archivos, la secuencia de 
archivos inicia una excepción de la clase lOException. 

• Open. que ordena a la secuencia de archivos que abra el archivo indicado 

• OpenOrCreate. que ordena a la secuencia de archivos que cree el archi¬ 
vo indicado. Si el archivo ya existe, el objeto FileStream abre el archi¬ 
vo indicado. 

• Trúncate, que ordena a la secuencia de archivos que abra el archivo 
indicado y. a continuación, lo trunca para que su tamaño sea cero bytes. 

La especificación del modo de acceso a archivos está representada por una 
enumeración llamada FileAccess. La enumeración FileAccess también 
se encuentra en el espacio de nombres .NET System. 10 de NET y admite los 
siguientes miembros de enumeración: 

• Read. que especifica que la clase FileStream debe permitir el acceso 
de lectura al archivo especificado. 

• ReadWr i te. que especifica que la clase Fi leSt ream debe permitir el 
acceso de lectura y escritura al archivo especificado. 

• Wr i te. que especifica que la clase FileStream debe permitir el acceso 
de escritura al archivo especificado. Se pueden escribir datos en el archi¬ 
vo. pero no se pueden leer. 

El constructor FileTestClass del listado 25.1 crea una nueva secuencia 
de archivos que gestiona un archivo llamado test. dat. El archivo se abre en 
modo de creación para el acceso de lectura y escritura. 

El método WriteBytes (') de FileTestClass se coloca en un bufer de 
256 de bytes. que crea el constructor de la clase. Se ubica en el búfer de 256 bytes 
con valores que van desde 00 hexadecimal a FF hexadecimal. A continuación se 
escribe el bufer en la secuencia mediante el método de secuencia de archivos 
Write ( ) . El método Write ( ) acepta tres argumentos: 

• Una referencia al búfer de bytes que contiene los datos que se van a escri¬ 
bir. 

• Un número entero que especifica el elemento de matriz del primer byte del 
bufer que se va a escribir. 

• Un número entero que especifica el numero de bytes que se van a escribir 
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El método Write ( ) es sincrónico y no regresa hasta que los datos se han 
escrito realmente en la secuencia. 

El método ReadBytes ( ) de Fi 1 eTestC 1 ass lee los 256 bytes escritos 
por WriteBytes { ) y compara los bytes con el patrón de bytes implementado 

por WriteBytes ( ) . 

La primera operación que realiza el método ReadBytes ( ) supone trasladar 
el puntero de la secuencia al principio del archivo La posición de las secuencias 
es un concepto importante y merece una especial atención. Las secuencias admi¬ 
ten el concepto de posicionamiento de fila. Una posición de secuencia hace refe¬ 
rencia a una posición en la secuencia donde tendrá lugar la próxima operación de 
E/S. Por lo general, una posición de secuencia se sitúa al principio de una secuen¬ 
cia cuando se inicializa esa secuencia. A medida que se leen o escriben datos en la 
secuencia, la posición de la secuencia avanza hasta la posición inmediatamente 
después de la última operación 

La figura 25.2 refleja este concepto. Muestra una secuencia con seis bytes de 
datos. 


Estado de la secuencia de archivos al inicializar el objeto 



posición 


Estado de la secuencia de archivos después de leer tres bytes 


A 

B 

C 

1 

i 

2 | 3 







posición 

Figura 25.2. La secuencia de E/S se mueve a la siguiente posición de secuencia 

Cuando la secuencia se abre por primera vez. la posición de secuencia apunta 
al primer byte de la secuencia. Esto aparece reflejado en el diagrama superior de 
la figura 25.2. Imagine que el codigo que gestiona la secuencia lee tres bytes del 
archivo. Se leen los tres bytes y la posición de secuencia apuntara al byte inme¬ 
diatamente después de la última posición que se ha leído. Siguiendo con el ejem¬ 
plo. la posición de secuencia apuntará al cuarto byte de la secuencia. Esto se 
refleja en la parte inferior del diagrama de la figura 25.2. 

La relación con el código 25.1 tiene que ver con el hecho de que se crea un 
archivo y se escriben 256 bytes en él. Cuando se han escrito los bytes. se leen. Sin 
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embargo, es importante recordar dos conceptos de posicionamicnto de secuen¬ 
cias: 

• La posición del archivo se actualiza después de cada operación de lectura 
o escritura, para señalar una posición inmediatamente posterior a la última 
operación. 

• Las operaciones de lectura y escritura empiezan en el byte al que hace 
referencia la posición de secuencia. 

Cuando el código del listado 25.1 crea la nueva secuencia de archivos, la 
posición de archivo es situada al principio del archivo (vacío). Tras escribir los 
256 bvtes. la posición del archivo se actualiza para hacer referencia a la posición 
inmediatamente posterior a los 256 bytes. Si el código va a leer los 256 bvtes 
inmediatamente después de la operación de escritura, la operación de lectura 
fallará porque la posición de secuencia apunta hacia el final del archivo tras la 
operación de escritura y la operación de lectura intentara leer 256 bvtes a partir 
de esa posición, pero no hay bvtes disponibles en esa posición. El codigo debe 
decir "antes de que empiece la operación de lectura, vuelve a apuntar el puntero 
del archivo hacia el principio de la secuencia para que la operación de lectura 
pueda realizarse." 

Esta tarea la realiza un método de la clase Strcam llamada Scck ; ) . El 
método Scck ( ) permite al codigo trasladar o buscar la posición de secuencia a 
cualquier posición disponible en la secuencia. El método Sookí) recibe dos 
parametros: 

• Un numero entero long. que especifica un desplazamiento de posición en 
bvtes. 

• Un valor de una enumeración llamada SeekOrigin. que especifica la 
posición de secuencia que debe usarse en el punto inicial para la operación 
de búsqueda. 

Ea enumeración Seekür i g i n se declara en el espacio de nombre System. 10 
v admite los siguientes v alores: 

• Beyi ri. que indica que la operación de búsqueda debe realizarse respecto 
al principio de la secuencia. 

• Current. que indica que la operación de búsqueda debe realizarse res¬ 
pecto a la actual posición de la secuencia. 

• End. que indica que la operación de búsqueda debe realizarse respecto al 
final de la secuencia 

El método Seek ( ) ajusta la posición de la secuencia para que apunte a la 
posición de secuencia a la que hace referencia la enumeración SeekOrigin. 
que se desplaza el numero especificado de bvtes. El desplazamiento de bvtes 
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usado en el método Seek ( ) puede ser positivo o negativo. El siguiente ejemplo 
usa un valor de desplazamiento positivo: 

File.Seek(4, SeekOrigin.Begin); 

La anterior línea ajusta el puntero de la secuencia para que apunte cuatro 
bytes más allá del principio de la secuencia. Los valores de desplazamiento posi¬ 
tivo desplazan el puntero de la secuencia hacia el final de la secuencia. El siguien¬ 
te ejemplo usa un valor de desplazamiento negativo: 

File.Seek (-2, SeekOrigin.End) ; 

Este ejemplo ajusta el puntero de la secuencia para que apunte dos bytes antes 
del final de la secuencia. Los valores de desplazamiento negativos desplazan el 
puntero de la secuencia hacia el principio de la secuencia. 

El código del listado 25 1 usa el siguiente codigo de búsqueda antes de que se 
lean los 256 bytes: 

BinaryFile.Seek (0, SeekOrigin.Begin) ; 

Esta llamada ajusta el puntero hacia el principio de la secuencia. Cuando 
empieza la operación de lectura, comienza leyendo desde el principio de la se¬ 
cuencia. 

El método ReadBytes ( ) usa el método FileStream llamado Read ( ) 
para realizar una lectura sincrónica de E/S en la secuencia. El método Read ( ) 
admite tres argumentos: 

• Una referencia al búfer de bytes que se usará para contener la lectura de 
bytes de la secuencia 

• Un numero entero que especifica el elemento de matriz del primer bytc en 
el búfer que contendrá la lectura de datos de la secuencia. 

• Un número entero que especifica el número de bytes que se van a leer. 

El método Read { ) es sincrónico y no regresa hasta que se han leído realmen¬ 
te los datos de la secuencia. Cuando la operación de lectura se completa, el código 
comprueba el patrón de bytes de la matriz para asegurarse de que concuerda con 
el patrón de bytes que se escribió. 

E/S asincrónica 

El listado 25.2 es una modificación del listado 25.1 que refleja la E/S 
asincrónica. A diferencia de la E/S sincrónica, en la que las llamadas para leer y 
escribir operaciones no regresan hasta que la operación esta completa, las llama¬ 
das a operaciones de E/S asincrónicas regresan poco después de ser llamadas. La 
operación de E/S actual se realiza de forma oculta, en un subproceso distinto 
creado por la implementación de los métodos de E/S asincrónicos de NET 
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Framework y cuando la operación se ha completado se advierte al código median¬ 
te un delegado. La ventaja de la E/S asincrónica es que el codigo principal no 
necesita depender de que se complete una operación de E/S. La realización de 
largas operaciones de E/S en segundo plano evita que la aplicación tenga que 
realizar otras tareas, como procesar los mensajes de Windows en aplicaciones de 
Windows Forms. 

Cómo leer de forma asincrónica 

El listado 25.2 mejora el listado 25.1 realizando la operación de lectura 
asincrónicamente. La operación de escritura sigue realizándose sincrónicamente. 
La secuencia se inicial iza de la misma manera, sin importar cómo se realiza la E/ 
S Las secuencias pueden manipularse asincrónicamente para todas las operacio¬ 
nes de E/S. de forma sincrónica para todas las operaciones de E/S o en una 
combinación de forma sincrónica y asincrónica. 

Listado 25.2. Escritura sincrónica, lectura asincrónica 

usmg System; 

using System.10; 

using System.Threading; 

class FileTestClass 

{ 

prívate FileStream BinaryFile; 
prívate byte [] ByteArray; 

prívate IAsyncResult AsyncResultImplementation; 
prívate AsyncCallback ReadBytesCompleteCallback; 

public FileTestClass() 

{ 

AsyncResult Implementat. ion = nuil; 

BinaryFile - new FileStream("test.dat", FileMode.Create, 
FileAccess.ReadWríte); 

ByteArray = new byte [256]; 

ReadBytesCompleteCallback - new 
AsyncCallback(OnReadBytesComplete^; 

} 


public void WnteBytes () 

{ 

int ArrayIndex; 


for(Arraylndex - 0; Arraylndex < 25c; Arraylndex++) 

ByteArray[Arraylndex] = (byte)Arraylndex; 

BinaryFile.Write(ByteArray, 0, 256); 


public void ReadBytes() 

{ 

BinaryFile. Seekf'O, SeekOrigin.BeginJ ; 
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AsyncResultImplementation = 

BinaryFile . BeginRead(ByteArray, 0 , 256, 

ReadBytesCompleteCallback, nuil); 

} 

public void OnReadBytesComplete(IAsyncResult AsyncResult) 

{ 

int Arraylndex; 
int BytesRead; 
int Failures; 

BytesRead = BinaryFile.EndRead(AsyncResult)/ 

Consolé .WriteLine ( "Bytes read.: {0} ,r , BytesRead) ; 

Failures = 0; 

for(Arraylndex = Ü; Arraylndex < 256; Arraylndex++) 

( 

íf(ByteArray[Arraylndex] != (byte)Arraylndez) 

{ 

Consolé.WriteLine("Read test failed for byte at 
offset {0}.", Arraylndex); 

Failures++; 

} 

) 

Consolé .WriteLine ■( "Read test failures: (0}", Failures); 

} 


public void Wait ForReadOper at íonToFimsh ( ) 

{ 

WaitHandle WaitOnReadlO; 

WaitOnReadlO = AsyncResultImplementation.AsyncWaitHandle; 
WaitOnReadlO.WaitOne(); 



class MainClass 

( 

static public void Main() 

{ 

FileTestClass FileTest - new FileTestClass(); 

FileTest.WriteBytes () ; 

FileTest.ReadBytes () ; 

FileTest . Wait ForReadOper at íonToFimsh ( ) ; 



El código de las operaciones de escritura del listado 25.2 se controla de forma 
sincrónica y su codigo es idéntico al código de las operaciones de escritura del 
listado 25.1. Sin embargo, la operación de lectura es bastante diferente. 

El código de las operaciones de lectura del listado 25.2 no empieza con una 
llamada al método sincrónico Read ( ) de la secuencia sino con una llamada al 
método asincrónico BeginRead ( ) Esta llamada admite cinco parámetros. Los 
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tres primeros concuerdan con los parametros admitidos con el método sincrónico 
Read ( ) . pero los dos últimos parámetros son nuevos: 

• Una referencia al bufer de bytes que se usará para contener la lectura de 
bytes de la secuencia. 

• Un número entero que especifica el elemento de matriz del primer bvtc en 
el bufer que contendrá la lectura de datos de la secuencia. 

• Un número entero que especifica el numero de bytes que se van a leer. 

• Datos específicos de llamada. 

El delegado callback debe ser un objeto de una clase llamada 
AsyncCallback. La clase AsyncCallback se declara en el espacio de nom¬ 
bres System de NET Framework y gestiona un método que no devuelve nada y 
admite una referencia a un interfaz llamada IAsyncResult. El listado 25.2 
crea una instancia de este delegado en el constructor de la clase FileTestClass: 

ReadBytesCompleteCallback - new AsyncCallback(OnReadBytesComplete); 

La clase FileTestClass del listado 25.2 incluye un nuevo método llama¬ 
do OnReadBytesComplete ( ) . que se usa como método delegado. El objeto 
Stream invoca a este delegado cuando se completa la operación de lectura. 

La interfaz IAsyncResult. que se emplea como parámetro para el delega¬ 
do AsyncCallback. se define en el espacio de nombres System de .NET 
Framework. Admite cuatro propiedades que pueden usarse para obtener más in¬ 
formación sobre la naturaleza de la operación asincrónica: 

• AsyncState. que es una referencia al objeto que se proporcionó como el 
último parámetro del método BeginRead ( ) . Los métodos de E/S 
asincrónicos permiten asociar datos con una operación específica del ulti¬ 
mo parámetro a un método de E/S. En la propiedad AsyncState hav 
disponible una copia de estos datos. El listado 25.2 no necesita que los 
datos se asocien a la llamada, por lo que pasa un valor nuil como último 
parámetro para BeginRead ( ) Como resultado, la propiedad 
AsyncState también tiene un valor nuil. Quizás quiera usar estos 
datos para, por ejemplo, diferenciar una llamada de E/S de otra. Por ejem¬ 
plo. puede usar la misma referencia de delegado en varias llamadas de E/S 
asincrónicas y quizas quiera pasar junto a ella los datos que diferencian 
una llamada de otra. 

• As yncWa i t Ha nd 1 e. que es una referencia a un objeto de clase 
WaitHandTe. La clase WaitHandle se declara en el espacio de nom¬ 
bres System. Threading de .NET Framework. Este objeto encapsula 
una sincronización de primitivos y sirve de clase base para los primitivos 
específicos, como mutex y semáforos. El codigo puede esperar en este 
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control para determinar cuándo la operación de lectura está realmente 
terminada. El código del listado 25.2 hace precisamente eso. 

• CompletedSynchronous 1 y. que es un booleano cuno valor es Trué 
si la llamada BeginRead ( ) se completa de forma sincrónica y False 
en caso contrario. Casi todas las implementaciones de secuencia devuelven 
False para esta propiedad cuando la interfaz hace referencia a una ope¬ 
ración de E/S asincrónica. 

• IsCompleted. que es un booleano cuno valor es True si el objeto 
Stream ha completado la operación asincrónica. Hasta ese momento, la 
propiedad tiene un valor False. El codigo puede destruir todos los recur¬ 
sos relacionados con secuencias después de que la propiedad 

IsComp 1 eted devuelve True. 

La llamada a BeginRead ( ) también devuelve una implementación de la 
interfaz IAsyncCallback. El codigo del listado 25.2 captura la referencia de 
interfaz para su uso posterior. 

El método AsyncCal lback. que. en el listado 25.2. es el método 
OnReadBytesComplete ( ) . es invocado por el objeto Strearri cuando se 
completa la operación asincrónica. La implementación que se muestra en el lista¬ 
do 25.2 empieza con una llamada a EndRead ( ) . que devuelve el numero de 
bvtes que se leen realmente desde la operación. Este numero debe ser igual al 
numero de bvtes que se solicito leer mediante BeginRead ( ) . 


TRUCO: La llamada a EndRead () en el listado 25.2 se muestra para 
que se pueda encontrar el número de bytes afectados por la operación 
asincrónica. Si el código no necesita este valor, no es necesario llamar a 

EndRead ( ). 


El resto de la implementación del método OnReadBytesOomp i ete ( } com¬ 
prueba el patrón de bv tes leídos por la operación de E/S y env ía sus resultados a 
la consola. El método Main ( ) del listado 25.2 agrega una nueva llamada de 
método al codigo del listado 25.1. que es para un método privado del objeto 
Fi leTestCiass llamado WaitForReadOperat.ionToFi ni sh ( ) . Como 
la operación de lectura asincrónica es la última operación del codigo. la aplica¬ 
ción puede salir antes de que se complete la operación de lectura. Recuerde que el 
procesamiento de la operación de E/S asincrónica se realiza en un subproceso 
diferente. Si el proceso principal sale antes de que el subproceso de E/S pueda 
terminar, el código de OnReadBytesComplete ( ) no tiene oportunidad de 
terminar. El método Wait ForReadOperat : onToFinish ( ) garantiza que 
la operación se complete antes de regresar a su invocador. 

El método Wait ForReadOperat ionToFini sh ( ) usa el temporizado!' 
de espera en la implementación de la interfaz IAsyncCa 1 lback para realizar 
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su trabajo. El método llama al método WaitHandle WaitOne ( ) para que 
espere hasta que el temporizador de espera esté marcado. La llamada a 
WaitOne ( ) no regresa hasta que el temporizador de espera está marcado. El 
objeto Stream marca el temporizador de espera sólo después de que la opera¬ 
ción de E/S se complete. Después de que la llamada a WaitOne () regrese, 
puede estar seguro de que toda la operación se ha completado. 

Cómo escribir de forma asincrónica 

Las operaciones de E/S asincrónicas son parecidas a las operaciones de E/S 
sincrónicas. La única diferencia es que se emplea el método BeginWr i te ( ) en 
lugar del método BeqinRead ( ) . El listado 25.3 perfecciona el listado 25.2 al 
implementar una operación de escritura asincrónica. 

Listado 25.3. Escritura asincrónica, lectura asincrónica 

using System; 
u s i n g S y s t e m . T O; 
using System.Threading; 

cldss FileTestClass 

{ 

prívate FileStream BinaryFile; 
prívate byte [] ByteArray; 

prívate IAsyncResult AsyncReadResultImplementation; 
prívate IAsyncResult AsyncWriteResultImplementation; 
prívate AsyncCallback ReadBytesCompleteCallback; 
prívate AsyncCa1lback WriteBytesCompleteCallback; 

public FiIeTestClass () 

{ 

AsyncReadResultImplementation - nuil; 

BinaryFile - new FileStream("test.dat" , FileMode.Create, 
FileAccess.ReadWrite); 

ByteArray = new byte [256]; 

ReadBytesComp]eteCa1lback - new 
AsyncCallback (OnReadBytesComp1e t e) ; 

Wr i t. eBytesC omp le t eCallback - n ew 
As yn eCallback(OnWr 1 1eBytesC omp1e t e) ; 

} 


public void WriteBytes0 

{ 

int ArrayIndex; 

for(Arraylndex = 0; Arraylndex < 256; Arraylndex++) 
ByteArray[Arraylndex] = (byte)Arraylndex; 

AsyncWriteResultImplementation = 

BinaryFi 1e.BeginWri te (ByteArray, 0, 256, 

Wr i t. eBytesC omp 1 eteCa] lback, nuil) ; 

f 
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public void ReadBytes() 

{ 

WaitForWriteOperatíonToFinish{); 
BmaryFile . Seek (0, SeekOrígin . Begin) ; 
AsyncReadResultImplementation = 
BmaryFile . BeginRead (ByteArray, 0, 256, 

ReadBytesCompleteCa1Iback, nuil); 

} 


public void OnReadBytesCo mp1e t e(IAsyncResult AsyncResult) 

{ 

int Arraylndex; 
int BytesRead; 
int Failures; 

BytesRead - BmaryFi le . EndRead (AsyncResult ) ; 

Consolé .WriteLme ( "Bytes read.: { 0 } " , BytesRead); 

Failures = 0; 

for(Arraylndex - 0; Arraylndex < 256; Arraylndex+t) 

{ 

íf(ByteArray[Arraylndex] ! = (byte)Arraylndex) 

{ 

Consolé .WriteLme ( M Read test failed for byte at 
offset {0}.", Arraylndex); 

Failures++; 

} 

} 

Consolé.WriteLine("Read test failures: {U}”, Failures); 

} 

public void Wai t ForReadOper at íonToFimsh () 

{ 

WaitHandle WaitCnReadlO; 

WaitOnReadlO = 

AsyncReadResultImplementation.AsyncWaitHandle; 

WaitOnReadlO.WaitOne(); 

} 


public void OnWnteBytesComplete (IAsyncResult AsyncResult ) 

{ 

Bina r yFi1e.EndWrite (AsyncResult) ; 

} 


private void Wai t ForWr iteOperat ÍonToFimsh ( ) 

{ 

WaitHandle WaitOnWritelO; 

WaitOnWritelO = 

AsyncWriteResultImplementation.AsyncWaitHandle; 
WaitOnWritelO.WaitOne ( ) ; 
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c 1 a s s M amClass 


í 

static public voicl Main {) 

{ 

FiieTestCia.ss FileTest = new Fi 1 eTestC1 ass () ; 

FileTest.WriteByt.es ( ) ; 

Fi 1eTest.ReadBytes () ; 

FileTest.WaitForReadOperatíonToFinish(); 



El método EndWritef) no devuelve un valor, a diferencia del método 
EndRead ( ) . Sin embargo, los dos métodos se bloquean hasta que se termina la 
operación de E S 

Escritores y lectores 


.NET Framework tiene muchas clases escritoras y lectoras que facilitan el 
trabajo con datos mas complejos que simples secuencias de bytes. Los lectores v 
los escritores encapsulan una secuencia y proporcionan un nivel de conversión 
que conv íerte los valores en sus secuencias de bytes equivalentes (para los escri¬ 
tores) \ viceversa (para los lectores). Las clases lectoras y escritoras de NET 
suelen tener un nombre que refleja el tipo de cambio de formato que realizan. Por 
ejemplo, la clase H t,r:d Te:: t.Wr i t.er escribe valores destinados para la infor¬ 
mación de respuesta de HTTP env iada por ASP.NET y la clase Str i ngReader 
lee valores escritos usando su representación de cadena. 

Las clases escritoras y lectoras también controlan varios esquemas de codifi¬ 
cación. algo imposible de realizar mediante objetos de secuencia de bajo nivel 
Por ejemplo, las clases derivadas de la clase abstracta TextWr iter. permiten 
al código C# escribir texto y codificarlo en la secuencia mediante los algoritmos 
codificadores ASCII. Unicode. UTF7 o UTF8 

Cómo escribir secuencias con BinaryWriter 

El listado 25.4 muestra la clase BinaryWriter en funcionamiento. La fun¬ 
ción de la clase BinaryWriter es convertir tipos de datos de C# en series de 
bytes que puedan escribirse en una secuencia subyacente. 

Listado 25.4. Cómo trabajar con la clase BinaryWriter 

usmg System; 

u sin g S ystem.10; 

class FileTestClass 

{ 
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private BinaryWriter Writer; 
prívate FileStream BinaryFile; 

public FileTestClass () 

{ 

BinaryFile = new FileStream("test.dat", FileMode.Create, 
FileAccess.ReadWrite); 

Writer = new BinaryWriter(BinaryFile) ; 

} 


public void WriteBinaryData( ) 

{ 

Writer.Write( 'a' ) ; 

Writer.Write(123); 

Writer.Write (45 6. 78S) ; 

Writer.Write("test string"); 


} 

class MainClass 

{ 

static public void Mam () 

{ 

FileTestClass FileTest = new FileTestClass () ; 

FileTest.WriteBinaryData(); 

} 

} 

El codigo del listado 25.4 tiene un diseño de clases igual al del listado 25.3. El 
código contiene una clase MainClass y una clase FileTestClass. El cons¬ 
tructor de la clase FileTestClass del listado 25.4 crea una secuencia de 
archivos v. a continuación, un objeto BinaryWriter. El constructor del objeto 
BinaryWriter. que establece la relación entre el escritor binario y la secuen¬ 
cia en la que escribe sus datos, recibe una referencia a la secuencia de archivos. 
En el listado 25.4. todos los datos escritos en el escritor binario terminan en la 
secuencia de archivos establecida en el constructor. El método WriteBi- 
naryData ( ) escribe un carácter, un número entero, uno doble y una cadena, en 
la secuencia subvacentc. La clase BinaryWr iter implementa varias sobrecai- 
gas de un método llamado Write ( ) . Las sobrecargas del método Write ( ) 
admiten la escritura en la clase escritora de los siguientes tipos de datos: 

• Booleanos 

• Bytcs 

• Matrices de bytes 

• Caracteres 

• Matrices de caracteres 

• Valores decimales 
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• Valores dobles 

• Valores enteros cortos con y sin firma 

• Valores enteros con y sin firma 

• Valores enteros ampliados con y sin firma 

• Sbytes 

• Valores de coma flotante 

• Cadenas 

Si compila y ejecuta el código del listado 25.4. se crea un archivo llamado 
test.dat. Puede examinar los contenidos del nuevo archivo en un editor 
hexadecimal para comprobar que las representaciones binarias de los valores se 
han escrito en el archivo. 

Cómo leer de secuencias con BinaryReader 

El listado 25.5 agrega la clase BinaryReader al código del listado 25.5. 
Esta clase vuelve a ensamblar los bytes de la secuencia comritiéndolos a sus 
tipos de datos originales y devuelve los valores al invocador. 

Listado 25.5. Cómo trabajar con la dase BinaryReader 


usinq S yytem; 
a sin q X yyt om.I O; 

<:■ 1 a y y F 1 1 e T e s t C1 a s y 
i 

p 11 va t e Bmar yReade r Reader; 
prívate BrnaryWriter Writer; 
p r i va t e F i 1 o 3 t r e am B i n a ryEdlc ; 

pulí 1 1 c FileTestClass f ) 

i 

Binar yFile - new FileStreamC'test.dat:", Fi leMode .Créate, 
Fi1eAce e ys.Rea dW rite) ; 

Writer - new BinaryWr ít er ( BmaryFi le ) ; 

Reader - new BinaryReader (BmaryFile) ; 

} 


public void ReadBinaryDataí| 

{ 

char ReadCharacter; 
double ReadDouble; 
int Readlnteger; 
string ReadString; 

BmaryFile . Seek (0, S e e k O r i g i n . B e g i n ) ; 
ReadCharacter - Reader.ReadChar(); 
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Readlnteger = Reader.Readlnt32 () ; 

ReadDouble = Reader.ReadDouble ( ) ; 

ReadString = Reader . ReadStrmg () ; 

Consolé.WriteLine("Character: {0}”, ReadCharacter); 

Consolé.WriteLine("Integer: {0}", Readlnteger); 

Consolé.WriteLine("Double: {0}", ReadDouble); 

Consolé.WriteLine("String: {0}", ReadString); 


public void WnteBinaryData () 

{ 

Writer.Write ( 'a' ) ; 
Writer.Write(123); 
Writer.Write(456.785); 
Writer.Writetest string"); 


} 

class Mainelass 

( 

static public void Main i) 

{ 

FileTestClass FileTest - new FileTestClass ( )| 

FileTest. WnteBinaryData () ; 

FileTest.ReadBinaryData () ; 



A diferencia de la clase BinaryWr iter. que contiene un método sobrecar¬ 
gado para todas las operaciones, la clase BinaryReader contiene un método 
de lectura distinto para cada tipo de datos. El eodigo del listado 25.5 usa algunos 
de estos métodos de lectura, como ReadChar ( ) y Read l nt32 ( ) . para leer 
valores de la secuencia escrita en el método Wr i. teBinaryData ( ) . Los valo¬ 
res que se leen de la secuencia se env ían a la consola. Al ejecutar el listado 25.5 se 
obtiene el siguiente resultado en la consola. 

Character: a 
Integer: 123 
Double: 456.789 

String: test string 

Cómo escribir XML con un formato correcto 
mediante la secuencia XmlWriter 


Las secuencias pueden hacer mas cosas aparte de leer y escribir datos en 
varias secuencias de datos. También pueden agregar valor a los datos que se 
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envían a través de la secuencia. Un buen ejemplo de esta tecnología es la clase 
XmlWriter. que encapsula en elementos XML con formato correcto los datos 
que se envían a una secuencia. El resultado es un documento XML con formato 
correcto con el que puede trabajar cualquier procesador de documentos XML. 
como muestra el listado 25.6. 

Listado 25.6. Cómo escribir XML con la clase XmlWriter 


us ing 

System; 


us ing 

S ys t em. 

10; 

u s i n g 

Sys t em. 

Xml; 

class 

XMLStre 

e amW riterClass 


{ 

prívate XmlTextWriter XmlWriter; 
public void WnteXML () 

í 

XmlWriter = new XmlTextWriter(Consolé.Out); 

XmlWriter.WriteStartDocument{); 

XmlWriter.WriteComment("Thís XML document was 
automatically generated by C# code."); 

XmlWriter.Wr 1 1eStartElement ("BOOK") ; 

XmlWriter.WriteElementString("TITLE", "C# Bible"); 

XmlWriter.WriteElementString("AUTHOR", "Jeff Ferguson"); 
XmlWriter.WriteElementString("PUBLISHER", "Wiley"); 
XmlWriter , WnteEndEl ement ( ) ; 

XmlWriter .WnteEndDocument () ; 



class MainClass 

{ 

static public void Main() 

{ 

XMLStreamWriterClass XMLStreamWriter = new 
XMLSt reamWnterClass () f 

XMLSt reamWr iter .WnteXML () ; 

} 

} 

El codigo del listado 25.6 crea una nueva instancia de la clase XmlWriter y 
la asocia a la secuencia de salida de la consola. El código simplemente llama a 
varios métodos de la clase XmlWriter para producir datos y los métodos ro¬ 
dean a esos datos con nombres de elementos XML que se especifican cuando se 
llama al método. 

Observe la siguiente línea del listado 25.6: 

XmlWriter.WriteElementString("AUTHOR", "Jeff Ferguson"); 
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Esta llamada ordena a la clase XmlWriter que escriba un elemento XML 
llamado <AUTHOR> cuno valor es <Brian Patterson>. al dispositivo de 
salida de la secuencia. La implementacion del método proporciona automáticamente 
la etiqueta de cierre XML 

Al compilar y ejecutar el código del listado 25.6. se envía el siguiente docu¬ 
mento XML con formato correcto a la consola de la aplicación: 

< ?xml version="1.0 " encoding="IBM437"?> 

<!--This XML document was automatically generated by C# code.- 


< B O O K > 

<TITLE>C# Bible</TITLE> 
<AUTHOR>Jeff Fercjusonc /AUTHOR - 

< PUBLISHER>Wi1ey</PUBLISHER> 

< / BOGK : • 


Resumen 


Las secuencias proporcionan compatibilidad con la E S sincrónica y asincrónica 
en las aplicaciones de C#. Las secuencias trabajan en el nivel de bytes y necesi¬ 
tan que se lean y escriban bloques de bytes. Los lectores y escritores encapsulan 
secuencias y proporcionan acceso a los datos en un nivel superior. Puede usar 
lectores v escritores para trabajar con los tipos de datos estándar de C #. lo que 
permite que los lectores y los escritores hagan conversiones entre los valores de 
tipos de datos y sus representaciones de bytes. 

Su código C# seguramente trabajara con lectores y escritores, ya que propor¬ 
cionan compatibilidad para trabajar con los tipos de datos estándar sin tener que 
ocuparse de realizar la conv ersión entre un valor de un tipo de dato y su represen¬ 
tación binaria. Sin embargo. las secuencias también están disponibles si cree que 
necesita trabajar con ellas directamente. Quizás también quiera trabajar con se¬ 
cuencias si los datos que está leyendo están en un formato propietario que no es 
compatible con las clases lectoras y escritoras estándar de NLI Lramcwork. 
También puede considerar la posibilidad de crear sus propias clases lectoras, 
derivadas de las clases base TextReader o StreamReader y usarlas para 
leer la secuencia de formato propietario. 
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26 


Cómo 


dibujar 
con GDI+ 


En Windows, el acceso mediante programación al subsistema de gráficos se 
consiguió por primera vez usando los API GDI disponibles desde Windows vi. 
GDI ofrecía a los programadores la posibilidad de controlar cualquier tipo de 
elemento de interfaz de usuario y esta función ha sido reconstruida desde cero en 
NET Framework. GDI+ ha reemplazado a GDI como el API que se usa para 
acceder a los subsistemas de gráficos de Windows. Con GDI+ puede acceder a 
fuentes, manipular cualquier tipo de imagen y trabajar con formas en las aplica¬ 
ciones de C#. Para conseguir una visión global de cómo usar GDH en sus aplica¬ 
ciones. debe comprender el modo de empleo de los objetos Graphics. Pen. 
Brush v Color. Con estos cuatro objetos, puede conseguir casi cualquier cosa 
que necesite hacer con las GUI y las imágenes de .NET. Este capítulo estudia 
estos objetos v le familiariza con el uso de GDI+ en C#. Las clases disponibles en 
GDI+ podrían llenar un libro de mil páginas, por lo que debe seguir usando SDK 
como referencia para la más compleja y menos usada funcionalidad gráfica que 
no se trata en este capítulo 

Cómo trabajar con gráficos 

Al trabajar con GDI+ en NET. el principal objeto con el que se debe trabajar 
es el objeto Graphics. Este objeto es la superficie real que se usa para pintar 


577 



formas, trabajar con imágenes o mostrar texto. Visual Basic 6 y versiones ante¬ 
riores incorporaban una limitada compatibilidad para trabajar con gráficos, lo 
que dificultaba a los programadores de VB la tarea de escribir aplicaciones gráfi¬ 
cas personalizadas 

Lo que VB hacia era mantener un registro de cómo se dibujaban en pantalla los 
formularios y los objetos de los formularios. La propiedad AutoRedraw permi¬ 
tía que los formularios dejasen a Windows mantener un registro de lo que estaba 
en la parte superior de las demás ventanas y. en caso de necesidad, dibujar de 
nuevo automáticamente un formulario si otro estaba encima de el durante un 
cierto periodo de tiempo. No hacía falta que se ocupara del proceso real de dibu¬ 
jar el formulario. 

En NET. sucede todo lo contrario. El objeto Graphics no recuerda cuando 
fue dibujado ni qué fue lo que dibujó Por tanto, es necesario dibujar de nuevo los 
objetos tantas veces como resulte necesario si otras ventanas están encima de una 
ventana concreta. Esto puede parecer pesado, pero la variable PaintEventArgs 
del evento Paint de un formulario puede controlar el proceso perfectamente Si 
el código de dibujo se mantiene allí, cada vez que Windows pinte el formulario, 
los objetos se generarán correctamente. 

El siguiente fragmento de código recibe una referencia a un objeto Graphics 
mediante la variable PaintEventArgs del evento Paint de un formulario: 

prívate void Form'l_Paint (ob j ect sender, 

System.Windows.Forms.PaintEventArgs p) 

{ 

Graphics g = p.Graphics; 

} 

También puede crear un objeto Graphics mediante el método 
CreateGraphics de un control o formulario. El siguiente código muestra el 
método CreateGraphics: 

prívate void createManually() 

{ 

Graphics g; 

g = this.CreateGraphics ; 

} 

El tercer y último modo de crear un objeto Graphics es pasar un archivo de 
imagen directamente al objeto al instanciarlo. como muestra el siguiente codigo al 
tomar una imagen de mapa de bits del sistema de archivos: 

prívate void createFromFile() 

{ 

Graphics g; 

Bitmap b; 

b = new Bitmap (@"C : \Enterpr ise.bmp") ; 

g - Graphics.Fromlmage(b); 

} 
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Si ha estado agregando estos fragmentos a un formulario de Windows, es 
obvio que no sucede nada cuando se ejecuta alguno de estos códigos. Para 
implementar realmente alguna funcionalidad, debe usar miembros de la clase 
Graphics para hacer que sucedan cosas. 


NOTA: Si crea un objeto Graphics medíale el método Create- 
Graphics, debe llamar a Dispose ea ese objeto de&pués de usarlo. Así 
se asegura de que el objeto Graphics se eümiaará tféln memoria. 


La tabla 26.1 enumera las propiedades de la clase Graphics y la tabla 26.2 
enumera los métodos disponibles de la clase Graphics. La clase Graphics se 
incluye en el espacio de nombres System. Drawing. que se agrega como refe¬ 
rencia por defecto cuando se crea una nueva aplicación Windows Forms. Esto no 
significa que no se puedan usar objetos Graphics en ASP.NET; de hecho, en 
ASP.NET se pueden escribir aplicaciones de proceso de imágenes extremada¬ 
mente depuradas usando objetos Graphics. 

Tabla 26.1. Propiedades de la clase Graphics 


Propiedad 

Descripción 

Clip 

Obtiene o establece un objeto Región que delimi¬ 
ta la región de dibujo de este objeto Graphics 

ClipBounds 

Obtiene la estructura RectangleF que delimita la 
región de recorte de este objeto Graphics 

CompositingMode 

Obtiene un valor que especifica cómo se dibujan 
las imágenes compuestas en el objeto Graphics 

CompositingQuality 

Obtiene o establece la calidad de la generación de 
las imágenes compuestas que se dibujan en el ob¬ 
jeto Graphics 

DpiX 

Obtiene la resolución horizontal de este objeto 

Graphics 

DpiY 

Obtiene la resolución vertical de este objeto 

Graphics 

InterpolationMode 

Obtiene o establece el modo de interpolación aso¬ 
ciado al objeto Graphics 

IsClipEmpty 

Obtiene un valor que indica si la región de recorte 
de este objeto Graphics está vacía 

IsVisibleClipEmpty 

Obtiene un valor que indica si la región visible de 
recorte de este objeto Graphics está vacía 
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Propiedad 

Descripción | 

PageScale 

Obtiene o establece la relación de escala entre las 
unidades universales y las unidades de página de 
este objeto Graphics 

Pagellnit 

Obtiene o establece la unidad de medida usada 
para las coordenadas de página de este objeto 

Graphics 

PixelOffsetMode 

Obtiene o establece un valor que especifica cómo 
se desplazan los píxeles durante el procesamiento 
de este objeto Graphics 

RenderingOrigin 

Obtiene o establece el origen de la generación de 
este objeto Graphics para la interpolación y los 
pinceles de trama 

SmoothingMode 

Obtiene o establece la calidad de la generación del 
objeto Graphics 

TextContrast 

Obtiene o establece el valor de la corrección gamma 
para la generación de texto 

TextRenderingHint 

Obtiene o establece el modo de generación para el 
texto asociado a este objeto Graphics 

Transform 

Obtiene o establece la transformación universal de 
este objeto Graphics 

VisibleClipBounds 

Obtiene o establece el rectángulo delimitador de 
este objeto Graphics 

Tabla 26.2. Métodos de la clase Graphics 

1 Método 

Descripción 

AddMetafileComment 

Agrega un comentario al objeto Metafile actual 

BeginContainer 

Guarda un contenedor Graphics con el estado ac¬ 
tual de este objeto Graphics y abre y usa un nue¬ 
vo contenedor de gráficos. 

Clear 

Limpia toda la superficie de dibujo y la rellena con 
el color de fondo especificado 

DrawArc 

Dibuja un arco que representa una porción de una 
elipse especificada por un par de coordenadas, un 
valor de altura y un valor de anchura 

DrawBezier 

Dibuja una curva spline Bézier definida por cuatro 
estructuras Point 
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Método 


Descripción 


DrawBeziers 

Dibuja una serie de curvas spline Bézier a partir de 
una matriz de estructuras Point 

DrawClosedCurve 

Dibuja una curva spline cardinal cerrada definida 
por una matriz de estructuras Point 

DrawCurve 

Dibuja una curva spline cardinal mediante una 
matriz de estructuras Point especificada 

DrawEIMpse 

Dibuja una elipse definida por un rectángulo 
delimitador especificada por un par de coordena¬ 
das, un valor de altura y un valor de anchura 

Drawlcon 

Dibuja la imagen representada por el objeto icón 
especificado en las coordenadas especificadas 

DrawlconUnstretched 

Dibuja la imagen representada por el objeto icón 
especificado sin escalar la imagen 

Drawlmage 

Dibuja el objeto image especificado en la posición 
especificada y con el tamaño original 

Drawlmagellnscaled 

Dibuja el objeto image especificado con su tama¬ 
ño original en la posición especificada por un par 
de coordenadas 

DrawLine 

Dibuja una línea que conecta los dos puntos espe¬ 
cificados por pares de coordenadas 

DrawLines 

Dibuja una serie de segmentos de línea que conec¬ 
tan una matriz de estructuras Point 

DrawPath 

Dibuja un objeto GraphicsPath 

DrawPie 

Dibuja una forma circular definida por una elipse 
especificada por un par de coordenadas, un valor de 
altura y un valor de anchura y dos líneas radiales 

DrawPolygon 

Dibuja un polígono definido por una matriz de es¬ 
tructuras Point 

DrawRectangle 

Dibuja un rectángulo especificado por un par de 
coordenadas, un valor de alto y un valor de ancho 

DrawRectangles 

Dibuja una serie de rectángulos especificados por 
estructuras Rectangle 

DrawString 

Dibuja la cadena de texto especificada en la posi¬ 
ción especificada con los objetos Brush y Font 
especificados 

EndContainer 

Cierra el contenedor de gráficos activo y restaura 
el estado que tenía este objeto Graphics al esta- 
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Método 


Descripción 


EnumerateMetafile 

ExcludeClip 

FilICIosedCurve 

FillEllipse 

FillPath 

FillPie 

FillPolygon 

FilIRectangle 

FilIRectangles 

FilIRegion 

Flush 

FromHdc 

FromHwnd 

Fromlmage 


do guardado por una llamada al método Begin- 
Container 

Envía los registros del objeto Meta file especifi¬ 
cado, de uno en uno, a un método de devolución 
de llamada para su presentación en un punto de¬ 
terminado 

Actualiza la región de recorte de este objeto 
Graphics con el fin de excluir el área especifica¬ 
da por una estructura Rectangle 

Rellena el interior de una curva spline cardinal ce¬ 
rrada, definida por una matriz de estructuras Point 

Rellena el interior de una elipse definida por un 
rectángulo de delimitación especificado por un par 
de coordenadas, un valor de altura y un valor de 
anchura 

Rellena el interior de un objeto GraphicsPath 

Rellena el interior de una sección de gráfico circu¬ 
lar definida por una elipse, determinada por un par 
de coordenadas, unos valores de anchura y altura 
y dos líneas radiales 

Rellena el interior de un polígono definido por una 
matriz de puntos, especificados por estructuras 

Point 

Rellena el interior de un rectángulo especificado 
por un par de coordenadas, un valor de anchura y 
un valor de altura 

Rellena el interior de una serie de rectángulos es¬ 
pecificados por estructuras Rectangle 

Rellena el interior de un objeto Región 

Fuerza la ejecución de todas las operaciones de 
gráficos pendientes y devuelve inmediatamente el 
control sin esperar a que finalicen las operaciones 

Crea un nuevo objeto Graphics a partir del 
identificador especificado en un contexto de dispo¬ 
sitivo 

Crea un nuevo objeto Graphics a partir del 
identificador especificado de una ventana 

Crea un nuevo objeto Graphics a partir del objeto 
image especificado 
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Método 


Descripción 


GetHalftonePalette Obtiene un identificador de la paleta actual de 

semitonos de Windows 

GetHdc Obtiene el identificador del contexto de dispositivo 

asociado a este objeto Graphics 

GetNearestColor Obtiene el color más próximo a la estructura Co¬ 

lor especificada 

IntersectClip Actualiza la región de recorte de este objeto 

Graphics como la intersección de la región de re¬ 
corte actual y la estructura Rectangle especifica¬ 
da 

IsVisible Indica si el punto especificado por un par de coor¬ 

denadas está contenido en la región de recorte vi¬ 
sible de este objeto Gra Phics 

MeasureCharacterRanges Obtiene una matriz de objetos Región, cada uno 

de los cuales delimita un intervalo de posiciones 
de caracteres dentro de la cadena especificada 

MeasureString Mide la cadena especificada al dibujarla con el ob¬ 

jeto Font especificado 

MultipIyTransform Multiplica la transformación universal de este obje¬ 

to Graphics y especificada en el objeto Matriz 

ReleaseHdc Libera un identificador de contexto de dispositivo 

obtenido mediante una llamada anterior al método 
GetHdc de este objeto Graphics 

ResetClip Restablece la región de recorte de este objeto 

Graphics en una región infinita 

ResetTransform Restablece la matriz de transformación universal 

de este objeto Graphics en la matriz de identida¬ 
des 

Restore Restaura como estado de este objeto Graphics el 

estado representado por un objeto GraphicsState 

RotateTransform Aplica la rotación especificada a la matriz de trans¬ 

formación de este objeto Gra phics 

| Save Guarda el estado actual de este objeto Graphics 

e identifica el estado guardado con un objeto 

GraphicsState 

ScaleTransform Aplica la operación de cambio de escala especifi¬ 

cada a la matriz de transformación de este objeto 
Graphics, anteponiéndola a esta última 



Método 


Descripción 


SetClip 


T ransformPoínts 


TranslateClip 


TranslateTransform 


Establece la región de recorte de este objeto 
Graphics en la propiedad clip del objeto 
Graphics especificado 

Transforma una matriz de puntos de un espacio de 
coordenadas a otro utilizando las transformaciones 
universal y de página actuales de este objeto 

Graphics 

Convierte la región de recorte de este objeto 
Graphics usando las cantidades especificadas en 
las direcciones horizontal y vertical 

Antepone la conversión especificada a la matriz de 
transformación de este objeto Graphics 


Como puede ver. la clase Graphics proporciona todos los métodos posibles 
que pueda necesitar para trabajar con cualquier tipo de elemento GUI. El listado 
26. 1 usa muchos de los métodos de la clase Graphics para producir el resulta¬ 
do que se muestra en la figura 26.1 


NOTA: Como no hay una propiedad AutoRedraw, todavía necesita un 
modo de volver a dibujar un formulario si se le asigna un nuevo tamaño. Si 
se usa el método SetStyles y se pasa el estilo ControlStyles. 
ResizeRedraw correctamente, se llamará al método Paint de un for¬ 
mulario para corregir su estilo. Tras la llamada, el objeto Initialize- 
Component de su formulario debe escribir SetStyle (ControlStyles 
. ResizeRedraw, true) para garantizar que se llamará al evento Paint 
cuando el formulario cambie de tamaño. Busque SetStyle en NET 
Framework SDK para aprender más sobre lo que puede hacer con el méto¬ 
do SetStyle. 


Listado 26.1. Cómo usar métodos de la clase Graphics 

prívate void drawLine() 

{ 

/* crea un objeto Graphics que puede ser recuperado 
* para cada una de las muestras */ 

Graphics g; 

g = this.CreateGraphics () ; 

// Use el objeto Pen para crear una linea 
Pen p; 
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p = new Pen (Color .Red, 50); 


/* DrawLine es un método sobrecargado, 

* pasa las coordenadas xl, y], x2 , y2 * / 

g.DrawLine(p, 100F, 100F, 50ÜF, 10ÜF); 

// dibuje un icono del sistema de archivos 
Tcon i ; 

i = new Icón (@"C: \Desktop. ico") ; 

// llame a Drawlcon y pasa las coordenadas x c y 
g.Drawlcon(i, 150, 15); 

// dibuje un rectángulo 
Pen p2; 

p2 = new Pen(Col or.PapayaWhip, 7) ; 

/* dibuje un rectángulo pasando x, y, 

* altura y anchura */ 

g.DrawRectangle (p2, 50, 50, i 00, 100); 

} 

Si llama a este método desde una aplicación Windows Forms. su resultado se 
parecerá a lo que aparece en la figura 26 . 1 . 



Figura 26.1. Resultado del uso de miembros de la clase Graphics 


La clase Graphics no hace nada por sí misma. Para crear lineas, rectángu¬ 
los. imágenes y fuentes, debe usar otros objetos junto al objeto Graphi es. L1 
listado 26. 1 crea un objeto Pen para usarlo en conjunción con el objeto Graphi es 
para dibujar una línea roja en el formulario. También crea un objeto Icón, que 
es usado por el objeto Graphics para dibujar el icono de escritorio en el formu¬ 
lario. Como ya se dijo antes, puede realizar numerosas tareas con GDI + : dibujar 
formas y líneas, manipular imágenes y trabajar con fuentes. Las siguientes sec¬ 
ciones profundizan en este tema, describiendo cómo puede usar objetos como 
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Pen. Brush c Image en combinación con miembros de la clase Graphics 
para aprovechar al máximo la inmensa colección de utilidades GDI+ de NET 

Cómo trabajar con Image en GDI+ 

Si necesita procesar imágenes existentes en el sistema de archivos, la clase 
Tmaqe le brinda la posibilidad de procesar imágenes en superficies creadas con 
el objeto Graphics. La clase Image se incline en el espacio de nombres 
System. Drawi ng y es una clase abstracta que le ofrece toda la funcionalidad 
que necesita para usar mapas de bits, iconos y metarchivos con un objeto 
Graphics para procesar objetos Image predefinidos en un formulario. Las 
imágenes procesadas pueden proceder directamente del sistema de archivos o de 
una secuencia de memoria. En cualquier caso, está tratando con algún tipo de 
fuente de imagen. Las imágenes pueden ser de tipo JPG. ICO o BMP 

En el listado 26.2. se abre un archivo JPG del disco local para que aparezca en 
un formulario. Este ejemplo es ligeramente diferente del que vimos anteriormente 
En éste, se sobrecarga el exento OnPaint. del formulario para que la imagen no 
sea eliminada si se sitúa otra ventana sobre la suya. Este ejemplo muestra como 
implementar llamadas al método Dispose en el objeto Graphics que se usa 
para pintar la imagen JPG cuando se destruye el formulario. 

Listado 26.2. Cómo usar imágenes con GDI + 

namespace RenderJPG 
{ 

public class Form'l : System.Windows . Forms . Form 

{ 

prívate System.ComponentModel.Container 
components - nuil; 

// declara la variable de imagen 
prívate Image img; 

pub 1 i. c Forml () 

{ 

InitlalizeComponent(); 

// abre la imagen 

img - new Bitmap(@"C: \money .jpg" ) ; 

// 

} 

protected override void Dispose ( bool disposxng ) 

{ 

i f ( disposing ) 

{ 

// Llama a DISPOSE sobre el objeto Img 
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i mg.Dis p o s e ( ) ; 

// 

if (components != nuil) 

í 

components.Dispose(); 


base.Dispose( disposing } ; 

} 

static void Main() 

{ 

Application.Run(new Forml()); 
} 


// sobrecarga el evento OnPaint 

protected override void OnPaint(PaintEventArgs p) 
{ 

Graphics g - p.Graphics; 
g.Drawlmage(img, 0,0); 

} 


} 

Si se ejecuta esta aplicación se producirá un resultado parecido al que aparece 
en la figura 26.2. 



^jnjxj 


Figura 26.2. Resultado del listado 26.2 usando un JPG con GDI + 


El método Drawlmage usado para dibujar la imagen en el formulario tiene 
casi 20 constructores sobrecargados. Básicamente, cada uno indica al método 
como dibujar la imagen, como coordenadas o como altura y anchura. Con un 
simple cambio en el método Drawlmage. puede rellenar todo el formulario con 
el mapa de bits. Si pasa la constante ClientRectangie a Drawlmage. 
como muestra el fragmento de codigo. obtendrá un resultado con un aspecto simi¬ 
lar al de la figura 26.3. con todo el mapa de bits rellenando la pantalla: 

// sobrecarga del evento OnPaint 

protected override void OnPaint (PaintEventArgs p) 

{ 


587 




Graphics g = p.Graphics; 
g.Drawlmage(ímg, ClientRectangle); 



Figura 26.3. La imagen rellena todo el formulario 

También puede devolver propiedades a una imagen sin mostrarla. El siguiente 
evento Load examina algunas de las propiedades disponibles de la imagen 
money. jpq que abrimos antes: 


prívate void Formi Load(object sender, System.EventArgs e) 

{ 

M e s s a g e B o x . S h o w 

i img.PhysicalDimension.ToString() ) ; 

MessageBox.S how 

( img.He ight.ToString( ) ); 

M e s s a g e B o x . S h o w 


(img.Width.ToString() ); 

MessageBoz.S h ow 

(img.RawFormat.ToString() ) ; 

MessageBo x.S h ow 

í img . Size .ToStnng () ) ; 

} 

La tabla 26.3 describe cada una de las propiedades disponibles para imágenes 
a través de la clase Image. 

Tabla 26.3. Propiedades de la clase Image 


Propiedad Descripción 


Flags Obtiene indicadores de atributo para este objeto 

Image 

FrameDimensionsList Obtiene una matriz GUID que representa las di¬ 
mensiones de los marcos de este objeto image 


Height 


Obtiene la altura de este objeto image 





Propiedad 

Descripción 

HorizontalResolution Obtiene la resolución horizontal, en píxeles por 

pulgada, de este objeto image 

Palette 

Obtiene o establece la paleta de colores de este 
objeto Image 

PhysicalDimension 

Obtiene la anchura y altura de este objeto image 

PixelFormat 

Obtiene el formato de píxeles de este objeto image 

PropertyldList 

Obtiene una matriz de los identificadores de pro¬ 
piedad almacenados en este objeto image 

Propertyltems 

Obtiene una matriz de objetos Propertyi tem que 
describe este objeto image 

RawFormat 

Obtiene el formato de este objeto image 

Size 

Obtiene la anchura y altura de este objeto image 

VerticalResolution 

Obtiene la resolución vertical, en píxeles por pul¬ 
gada, de este objeto image 

Width 

Obtiene el ancho de este objeto image 

También puede usar varios métodos de la clase Image. que le permite mani¬ 
pular imágenes de un modo prácticamente ilimitado El siguiente codigo voltea la 
imagen 90 grados: 

ímg.RotateFlip(RotateFlipType.Rotate9OFlípY ) ; 

La enumeración RotateFlipType permite especificar como quiere girar o 
voltear una imagen sobre una superficie de gráficos. 

La tabla 26.4 enumera los métodos restantes de la clase Image que puede 

usar para manipular 

una imagen. 


Tabla 26.4. Métodos de la clase Image 

1 Método 

Descripción 

Clone 

Crea una copia exacta de este objeto image 

FromFile 

Crea un objeto image a partir del archivo especifi¬ 
cado 

FromHbitmap 

Crea un objeto Bitmap a partir de un identificador 
de Windows 

FromStream 

Crea un objeto image a partir de la secuencia de 
datos especificada 
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Método 


Descripción 


GetBounds 

Obtiene un rectángulo delimitador para este objeto 
image en las unidades especificadas 

GetEncoderParameterList 

Devuelve información sobre los parámetros que 
admite el codificador de imágenes especificado 

GetFrameCount 

Devuelve el número de marcos de la dimensión 
especificada 

GetPixelFormatSize 

Devuelve la profundidad de color (número de bits 
por píxel) del formato de píxel especificado 

GetPropertyltem 

Obtiene el elemento de propiedad especificado de 
este objeto Image 

GetThumbnail Image 

Devuelve la vista en miniatura de este objeto image 

IsAlphaPixelFormat 

Devuelve un valor que indica si el formato de píxel 
de este objeto image contiene información alfa 

IsCanonicalPixelFormat 

Devuelve un valor que indica si el formato de píxel 
es canónico 

IsExtendedPixelFormat 

Devuelve un valor que indica si el formato de píxel 
es extendido 

RemovePropertyltem 

Quita el elemento de propiedad especificado de este 
objeto Image 

RotateFlip 

Este método gira, voltea o gira y voltea el objeto 

Image 

Save 

Guarda este objeto image en el objeto stream con 
el formato especificado 

SaveAdd 

Agrega la información del objeto image especifi¬ 
cado a este objeto Image. El objeto Encoder 
Parameters especificado determina cómo se 
incorpora la nueva información a la imagen exis¬ 
tente 

SelectActiveFrame 

Selecciona el marco que especifica la dimensión y 
el índice 

SetPropertyltem 

Establece el elemento de propiedad especificado 
en el valor especificado 


( orno ha podido ver en esta sección, la clase Image ofrece funciones muy 
sólidas cuando se usan con un objeto Graphics. En la siguiente sección apren¬ 
dera a usar lapices y pinceles para trabajar con imágenes y dibujar formas y 
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Cómo trabajar con lápices y pinceles 


Como vimos en la clase Image. el espacio de nombres System. Drawi ng 
ofrece todo lo que necesitamos para trabajar con imágenes procedentes de una 
secuencia o del sistema de archivos. NET Framevvork también ofrece compatibi¬ 
lidad integrada para trabajar con formas, líneas e imágenes mediante las clases 
Pen y Brush. Esta sección muestra como trabajar con las clases Pen y Brush 
para manipular formas, líneas e imágenes y lograr los electos deseados. 

Cómo usar la clase Pen 

La clase Pen permite dibujar líneas y cunas sobre una superficie de gráficos 
El espacio de nombres que contiene las funciones que usan las clases Pen y 
Brush es el espacio de nombres System. Drawi.ng . DrawingPD. de modo 
que asegúrese de agregarlo junto a la instrucción de uso de sus archivos de clase. 
Al establecer varias propiedades en una instancia de Pen. puede modificar la 
apariencia de lo que muestra el lápiz. Al invocar métodos de la clase Graphics, 
puede indicar el tipo de forma que quiere mostrar. 

El siguiente codigo establece las propiedades Color y DashStyle para 
crear una elipse similar a la que aparece en la figura 26.4 

prívate void Forml_Load(object sender, 

System.EventArgs e) 

{ 

Pen p - new Pen (Color.Blue, 1ü) ; 
p.DashStyle - DashStyle.DashDot ; 

Graphics g • this.CreateGraphics(); 
g.DrawEllipse (p, 10, 15, 105, 250); 

} 



Figura 26.4. Dibujo de una elipse usando las propiedades Color y DashStyle 
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La tabla 26.5 recoge los valores posibles de la enumeración usada para esta¬ 
blecer el estilo de la línea discontinua de la elipse. 

Tabla 26.5. En umeración DashStyle 


Valor 

Descripción 

Custom 

Especifica un estilo de guión personalizado defini¬ 
do por el usuario 

Dash 

Especifica una línea formada por guiones 

DashDot 

Especifica una línea formada por un modelo de 
guión y punto que se repite 

DashDotDot 

Especifica una línea formada por un modelo de 
guión, punto y punto que se repite 

Dot 

Especifica una línea formada por puntos 

Solid 

Especifica una línea continua 


También puede personalizar líneas con las propiedades StartCap y EndCap 
usando la enumeración LineCap. que también se incluye en el espacio de nom¬ 
bres System. Drawing . Drawing2D. El listado 26.3 muestra algunas varia¬ 
ciones que usa la enumeración LineCap para dibujar diferentes tipos de líneas, 
cuyo resultado puede ver en la figura 26.5. 

Listado 26.3. Cómo usar la enumeración LineCap 

protected overnde void OnPaiüt (PamtEventAr gs e) 

{ 

Graphics g - e.Graphics; 

Pen p - new Pen(Color.Brown, 15); 

// establece la flecha 
p.StartCap = LineCap.ArrowAnchor ; 
p.EndCap - LineCap.ArrowAnchor ; 
g . DrawLme (p, 30 , 30, Width-50, 30); 

// extremos redondeados 
p. StartCap - LineCap.Round ; 
p.EndCap - LineCap.Round ; 
g . Dr awLme (p , 3 0 , 80, Width-50, 80); 

// delimitador redondo 

p. StartCap - LineCap.RoundAnchor ; 

p.EndCap - LineCap.RoundAnchor ; 

g.DrawLine(p , 30 , 12 0, Width-50, 120); 

// triangulo 
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p.StartCap = LineCap.Triangle ; 
p.EndCap = LineCap.Triangle ; 
g . D r a wL me (p, 30, ISO, Width-5 0, ISO); 

// delimitador cuadrado 
p.StartCap = LineCap.SquareAnchor; 
p.EndCap - LineCap.SquareAnchor ; 
g .DrawLine (p,30, 190, Width-50, 190); 


} 

La figura 26.5 muestra el resultado de la ejecución del codigo anterior usando 
la enumeración LineCap. 



Figura 26.5. Cómo usar la enumeración LineCap 

Cómo usar la clase Brush 

El uso de la clase Brush en conjunción con un objeto Graphics permite 
procesar imágenes y objetos sólidos sobre una superficie de gráficos. El siguiente 
código muestra cómo crear una elipse continua rellena: 

protected override void OnPaint(PaintEventArgs e) 

{ 

Graphics g - e.Graphics; 

SolidBrush sb = new SolidBrush(Color.Black i ; 

g.FillEllipse(sb, ClíentRectangle); 

} 

Si se ejecuta el código anterior se produce una imagen como la que aparece en 
la figura 26.6. 

Se pueden crear varios tipos de pincel. Un SolidBrush. el que se uso en e 
anterior ejemplo, rellena una forma con un color solido. El uso de un HatchBrush 
permite improvisar la apariencia de sus gráficos. HatchBrush usa las enume¬ 
raciones HatchStyle y HatchFill para mostrar los diferentes tipos de pa¬ 
trones El listado 26.4 dibuja algunas de las variaciones de HatchBrush mediante 
la enumeración HatchStyle. Esta enumeración tiene mas de 40 miembros, de 
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modo que merece la pena buscarla en el SDK de NET Framework. Si alguna 
vez necesita crear algún tipo de patrón de dibujo, puede encontrar una ayuda 
vital 





Figure 26.6. Elipse sólida creada con pincel 


Listado 26.4. Cómo usar la clase HatchBrush con HatchStyles 

prot.ected ove r riele void OnPaint (Paint EventArgs e) 

I 

Graphics g - e.Graphics; 

HatchBrush hb - 
new HatchBrush 
( H a t c h S t y 1 e . P1 a i d , 

Color . Ant i queWhi. t e , Color . Black) ; 
g . F i 11 K 1. 1 i p s e (h b , 3 0 , 3 0, W i d t h - 5 0 , 30); 


HatchBrush hbS - new HatchBrush 
(Hat chSty1e.La rgeCheckerBoard, 

C o 1 o r.Antiqu eWhite ,Color.Black) ; 


g . F 1 1 1 Fd 1 i p s e ( h b 3 , 3 0, 

8 0, Width-5 0, 

30) ; 

Hat ch B r u s h h b 3 = 

new HatchBrush 

(HatchStyle.DashedHorizontal, 


Color.AntiqueWhite 

,Color.Black); 


g.Fi||El 1 ipse(hb3, 3 0, 

130, Width-50, 

30) 

Hat chB rush hb4 = 

new HatchBrush 
(HatchStyle.ZigZag, 

C o1 o r.An tiqu eWhit e 

,Color.Black) ; 


g . F i 1 1 Fd 1 i p s e ( h b 4 , 3 0, 

180, Width-50, 

30) 
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Si se ejecuta el código anterior se produce una imagen como la que aparece 
en la figura 26.7. 



Figura 26.7. HatchBrush con diferentes HatchStyles 

La tabla 26.6 describe cada uno de los tipos de lápiz disponibles en la enume¬ 
ración PenType que puede usar con la clase Brush. Ya hemos visto HatchFi i 1 
y SolidColor en funcionamiento. 

Basándose en sus descripciones, probablemente pueda imaginar los otros tipos 
de pincel sin verlos en funcionamiento. 

Tabla 26.6. Enumeración PenType 


Miembro 

Descripción 

HatchFill 

Especifica un relleno de trama 

LinearGradient 

Especifica un relleno de degradado lineal 

PathGradient 

Especifica un relleno de degradado del trazado 

SolidColor 

Especifica un relleno sólido 

TextureFill 

Especifica un relleno de textura de mapa de bits 


El trabajo con texto y fuentes también requiere emplear un objeto Brush 
junto con un objeto Graphics. Para usar texto, se crea una instancia de la clase 
Pont, que se incline en el espacio de nombre System. Drawinq y establecer 
las propiedades aspecto, estilo y tamaño de texto y luego se llama al método 
DrawString desde el objeto Graphics que contendrá el pincel. El listado 
26.5 dibuja la frase C# is cooj en el formulario en uso y produce algo 
parecido a la imagen de la figura 26.8. 
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Listado 26.5. Cómo usar el método DrawString 


protected override void OnPaint(PaintEventArgs e) 
{ 

Graphics g = e.Graphics; 
e.Graphics .FillRectangle ( 

new SolídBrush(Color.White), 

ClientRectangle); 

g.DrawString("C# ís cool", this.Font, 
new SolidBrush(Color.Black), 15, 15); 

I 


NOTA: En .NET, las fuentes que se usan en un objeto Form se heredan de 
la misma forma. En este ejemplo, la propiedad fuente del formulario recibe 
el valor 24, de modo que cuando se pasa el valor this . Font al método 
DrawString, se usa el actual tamaño de fuente de formulario. 



Figura 26.8. Cómo usar el método DrawString y la clase Font para producir texto 


La tabla 26.7 enumera las propiedades disponibles de la clase Font. Al esta¬ 
blecer o recuperar estas propiedades en sus objetos Font. puede controlar com¬ 
pletamente el aspecto del texto en la pantalla. 

Tabla 26.7. Font Class Properties 


Propiedad 

Descripción 

Bold 

Obtiene un valor que indica si este objeto Font 
está en negrita 

FontFamily 

Obtiene el objeto FontFamily asociado a este ob¬ 
jeto Font 

GdiCharSet 

Obtiene un valor de bytes que especifica el conjun¬ 
to de caracteres GDI que utiliza este objeto Font 

GdiVerticalFont 

Valor booleano que indica si este objeto Font se 
deriva de una fuente vertical de GDI 

Height 

Devuelve la altura de este objeto Font 

Italic 

Obtiene un valor que indica si este objeto Font 
está en cursiva 
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Propiedad 


Descripción 


Ñame 

Size 

SizelnPoints 

Strikeout 

Style 

Underline 

Unit 


Obtiene el nombre del tipo de letra de este objeto 

Font 

Obtiene el tamaño eme de este objeto Font en 
unidades de diseño 

Obtiene el tamaño, en puntos, de este objeto Font 

Obtiene un valor que indica si este objeto Font 
especifica una línea horizontal de tachado de la 
fuente 

Obtiene la información de estilo de este objeto Font 

Obtiene un valor que indica si este objeto Font 
está subrayado 

Obtiene la unidad de medida de este objeto Fort 


Resumen 


GDI+ ofrece una consistente matriz de clases que le permite escribir cualquier 
tipo de soporte gráfico en sus aplicaciones. Este capitulo presentó una vista gene¬ 
ral de las funciones de GD1+. pero puede hacer muchas más cosas con los espa¬ 
cios de nombre System.Drawing y System.Drawing.Drawing2D que 
pueden explicarse en un sólo capitulo. 

Para manipular o crear gráficos usando GD1+. primero debe crear un objeto 
Graphics que le proporciona una superficie en la que pintar. Una vez creado 
el objeto Graphics, puede usar lápices, pinceles, mapas de bits o fuentes para 
procesar el tipo de imagen deseado. 
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27 


Cómo 


construir 
servicios Web 


Los servicios Web son. probablemente, el rasgo mas innovador y apasionante 
de la iniciativa NET de Microsoft y probablemente afecte al modo en que las 
empresas interactúan mediante las aplicaciones de ordenador. Pero, ¿qué es exac¬ 
tamente un servicio Web? A grandes rasgos, un servicio Web es simplemente un 
componente de servidor que puede ser inv ocado en Internet Este componente de 
servidor normalmente realiza un servicio fundamental de negocios, como la au- 
tentificación del usuario, la v alidación de tarjetas de crédito, el cálculo del precio 
de un seguro de derivados, la tramitación de una solicitud de compra de acciones 
o el calculo del precio de un env ío el mismo día. Obviamente, la lista de posibles 
servicios Web es tan variada como la lista de posibles oportunidades de negocio. 
Los serv icios Web permiten a las aplicaciones inv ocar servicios de negocios me¬ 
diante un mecanismo basado en estándares (usando XML y HTTP) y como verá 
en este capitulo, el modo de realizar esto supone un importante avance en la 
interoperabilidad de las aplicaciones. La mayoría de los estándares usados para 
crear servicios Web se realizan con XML. Si no está familiarizado con XML. 
puede leer una breve introducción en el apéndice de este libro. 

En este capítulo se estudiará qué estándares de XML controlan la definición y 
el uso de los serv icios Web A continuación crearemos un servicio Web mediante 
Visual Studio NET. Por último, usaremos este serv icio Web en un segundo pro¬ 
vecto de Visual Studio NET. 
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Funcionamiento de los servicios Web 


Al definir los servicios Web hay que contar con dos tecnologías opcionales: el 
mecanismo de descubrí míenlo y la descripción de servicio. Se pueden evitar 
estas dos tecnologías usando otros medios de comunicación; por ejemplo, si hay 
comunicación (llamadas de telefono) entre los programadores del serv icio Web y 
los programadores del cliente que accederá al servicio Web. El mecanismo de 
descubrimiento usa un documento XML de servidor para permitir que las aplica¬ 
ciones cliente detecten la existencia de un servicio Web y encuentren una descrip¬ 
ción detallada de ese servicio Al principio. Microsoft propuso usar DISCO 
(descubrimiento de servicios Web) para este mecanismo de descubrimiento, pero 
desde entonces UDDI (Descripción, descubrimiento e integración universales) se 
ha convertido en el estándar real para los descubrimientos. Puede encontrar mas 
información sobre UDDI en http : //www .uddi.org. La descripción de ser¬ 
vicio describe las entradas y salidas del servicio Web. Las descripciones de servi¬ 
cio usan el estándar Lenguaje de descripción de servicio Web (WSDL). descrito 
en este mismo capítulo. UDDI (o DISCO, su despreciado predecesor ahora) y 
WSDL son partes esenciales que pueden usarse para crear detallada documenta¬ 
ción sobre cómo invocar un servicio Web. Como estas tecnologías están 
estandarizadas, las descripciones también pueden ser leídas por aplicaciones. Sin 
embargo, después de que se ha implementado un cliente, no hay necesidad de usar 
el mecanismo de descubrimiento ni de hacer referencia a la descripción de serv 1 - 
cio El uso de estas tecnologías no es indispensable para crear o usar serv icios 
Web orientados a una aplicación concreta. 

En la invocación real de un servicio Web toman parte tres tecnologías: el 
pro! ocol o de conexión . el formato de mensaje x el mecanismo de invocación 
Solo los dos primeros están especificados en los servicios Web estándares. El 
protocolo de conexión es el mecanismo de transporte que se emplea para estable¬ 
cer la comunicación entre el cliente y el serv idor. Por lo general, suele ser HTTP, 
el protocolo de Internet basado en TCP/IP. El formato de mensaje es el formato 
que se emplea para inv ocar un serv icio Web. Un serv icio Web puede ser inv ocado 
mediante HTTP puro o con un mensaje XML en un formato específico llamado 
Protocolo de acceso simple a objetos (SOAP) La tercera tecnología, que controla 
cómo se llaman a los componentes de servidor, no está especificada por los 
estándares del serv icio Web. Este es un detalle de implementación que queda a la 
elección de la persona que implementa el servicio Web. En otras palabras, el 
programador que crea el serv icio Web elige la tecnología usada para llamar al 
código de negocio en el servidor: un programador de Visual Basic puede usar 
COM + para invocar un objeto COM. un programador de Java puede usar RMI 
para invocar un objeto Java y así sucesivamente. 

Las dos partes de un serv icio Web pueden describirse como el creador (cliente) 
y el consumidor (servidor). El creador desarrolla el componente de servidor y 
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muestra este servicio a quien corresponda. Por ejemplo, una institución financiera 
desarrolla un sistema de validación de tarjetas de crédito > lo muestra a los vende¬ 
dores conectados. Mostrar un servicio Web significa publicar la URL que los 
usuarios necesitan para invocar al servicio Web. H1 consumidor puede usar el 
serv icio expuesto enviando un mensaje de petición SOAP a la URL publicada. Al 
recibir una petición SOAP escrita en XML. el componente de servidor tras el 
servicio Web es invocado en el servidor del creador. Los resultados de esta invo¬ 
cación toman el formato de un mensaje de respuesta SOAP y se env ían de v uelta 
al consumidor del servicio. La figura 27.1 muestra los distintos elementos que 
toman parte en un servicio Web. 



Petición SOAP 
(XML) 

Respuesta SOAP 
(XML) 


Consumidor de 
servicios Web 



Petición SOAP 


(XML) 




i 


Respuesta SOAP 



(XML) 


i[ 


Creador dei servicio Web 


Invocación 


Componente 
de servidor 


Figura 27.1. Los servicios Web constan dos partes: un consumidor y un creador 


Los serv icios Web usan un conjunto de estándares para definir cómo se realiza 
la interacción entre cliente y serv idor. Estos estándares definen el mecanismo de 
transporte que se va a usar y el formato y contenido de la interacción. En el nivel 
de transporte, se usa el omnipresente protocolo de Internet HTTP El servidor y el 
cliente se comunican entre sí mediante mensajes XML. El contenido de estos 
mensajes también esta estandarizado y debe cumplir las reglas de SOAP (mas 
adelante se explicarán estas reglas) La naturaleza de los serv icios disponibles en 
un servicio Web puede ser descrita en un archivo XML cuyo contenido cumpla 
con las reglas del Lenguaje de descripción de serv icio Web (WSDL). Por último, 
un cliente puede descubrir dinámicamente que serv icios Web estas expuestos en 
un serv idor recuperando el archivo XML cuy o contenido cumple con las reglas de 
DISCO 

Observe que aún no se ha mencionado ninguna tecnología específica de com¬ 
pañías. En ninguna parte se ha presupuesto el sistema operativo del cliente o el 
servidor, el lenguaje de programación usado para escribir el componente del ser- 
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vidor o el mecanismo usado para invocar el componente del servidor. Estas elec¬ 
ciones no tienen importancia para un servicio Web. Un cliente escrito en C# que 
se ejecuta en Windows XP. por ejemplo, puede invocar un servicio Web escrito en 
Java ejecutándose en Sun Solaris. De hecho, un cliente no tiene modo de saber 
qué tecnologías se usan para mostrar el servicio Web. 

Las implicaciones de los servicios Web son enormes. Microsoft comenzó la 
programación basada en componentes con la introducción de los controles OLE 
(OCX), una versión depurada de los innovadores conceptos presentados por los 
Controles de Visual Basic (VBX). Los OCX se basan en el Modelo de objetos de 
componentes de Microsoft (COM) y funciona perfectamente. Sin embargo. COM 
v su contrapartida distribuida, el Modelo de objetos de componentes distribuido 
de Microsoft (DCOM). tienen un alcance limitado. Aparte de la familia de siste¬ 
mas operativos Windows, muy pocos sistemas admiten COM/DCOM. Ademas, 
aunque la familia Windows tiene una amplia aceptación para aplicaciones de 
escritorio, en la modalidad de servidor se usan una gran variedad de sistemas 
operativos. Por ejemplo, muchas variedades del sistema operativo UNIX, como 
Solaris y Linux, tienen una importante presencia. Los servicios Web eliminan la 
necesidad de decidir el sistema operativo que se ejecuta en el servidor al integrar 
dos aplicaciones Web. Al usar servicios Web puede ensamblar aplicaciones Web 
usando componentes de otros servidores. Por ejemplo, puede usar un servicio 
Web de una compañía de tarjetas de para validar tarjetas de crédito, un servicio 
Web de una compañía distribuidora para determinar los gastos de envió y así 
sucesivamente. Ésta es la esencia y la oferta de los servicios Web: la siguiente 
generación de programación basada en componentes para la siguiente generación 
de aplicaciones distribuidas. 


Servicios Web y Visual Studio .NET 

Si los servicios Web son independientes de la plataforma en la que se ejecutan, 
¿que espera conseguir con esto Microsoft? La respuesta es sencilla: Microsoft ha 
anunciado publicamente que intentara hacer de Windows el mejor sistema ope¬ 
rativo para hospedar servicios Web y de Visual Studio NET el mejor entorno de 
desarrollo para crear servicios Web. 

Como este libro trata de C#. nuestro estudio de los servicios Web se va a 
centrar en C# y en su entorno de desarrollo integrado. En la sección práctica de 
este capítulo podrá juzgar por sí mismo lo flexible y sencillo de usar que es el 
entorno de desarrollo Visual Studio NET. 

Visual Studio NET logra un fantástico trabajo simplificando la creación y 
consumo de servicios Web. La mayor parte de las tareas que odian los programa- 
dores (por ejemplo, crear documentos XML) se realizan automáticamente, sin 
requerir un gran esfuerzo por parte del programador. Todo lo que tiene que hacer 
al programar es declarar su intención de mostrar un fragmento de código como un 
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servicio Web y la herramienta se encarga de casi todo el trabajo. De hecho, la 
herramienta hace un trabajo tan bueno que nunca verá XML al construir un servi¬ 
cio Web y un consumidor de servicio Web. De hecho, esto es exactamente lo que 
va a hacer en este capítulo. Sin embargo, antes de empezar, observe el concepto 
que hace posible toda esta automatización: la programación basada en atributos 

La programación basada en atributos es un potente concepto que permite a 
Visual Studio NET automatizar una gran cantidad de pesadas tareas de progra¬ 
mación (como crear un documento WSDL para un servicio Web). Simplemente 
tiene que marcar un fragmento de código, como una clase o un método, de un 
modo especial para indicar lo que quiere hacer con el. Como resultado. Visual 
Studio NET genera los archivos necesarios para implementar su función. Un 
breve ejemplo servirá para mostrar como funciona al transformar una clase en un 
servicio Web. 

El listado 27.1 muestra como puede implementar un sencillo juego. De acuer¬ 
do. este luego no es muy entretenido (el jugador siempre pierde), pero este capitu¬ 
lo trata sobre la programación de servicios Web. no sobre programación de juegos. 
Observe los elementos necesarios para convertir este fragmento de codigo en un 
servicio Web y lo que Visual Studio NET genera durante este proceso. El princi¬ 
pal objetivo de este ejercicio es que se haga una idea de la cantidad de trabajo 
necesario para convertir un fragmento de codigo completo en un serv icio Web 
usando Visual Studio NET. 

Listado 27.1. Un sencillo juego 

namespace MyFirstWebService 

{ 

public class GameWS 
{ 

// Ejemplo de un sencillo juego 

// El juego de ejemplo devuelve la cadena "Sorry, you 
// lose!" 

// Para probar este juego, pulse F5 
public string Play (stnng opponentÑame) 

{ 

return "Sorry " + opponentName + ", you lose!"; 

} 

} 

} 

El primer paso para conv ertir este fragmento de código en un servicio Web es 
guardar el código en un nuevo archiv o llamado GameWS . asmx. A continuación, 
realice estos cuatro pasos: 

1. Agregue un título que indique tres cosas: que el archivo contiene un servi¬ 
cio Web. el lenguaje que usa y la clase que contiene la implementación: 

< @ WebService Language="c#" 

C1ass="MyFirstWebService.GameWS" > 
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2. Agregue lina directiva System. Web . Service inmediatamente debajo 
del titulo del servicio Web: 

us mg System. Web . Services ; 

3. Marque la clase como servicio Web y escoja el espacio de nombres XML 
asociado al servicio Web: 

[WebService (Namespace="http://www.boutquin.com/GameWS/") ] 
public class GameWS : System.Web.Services.WebServrce 

4. Marque los métodos de la clase como accesibles desde la Web: 

[WebMethod] 

public string Play (stnng opponentName) 

F4 listado 27.2 muestra el resultado final. También se han cambiado los co¬ 
mentarios para reflejar los cambios al codigo original realizados. 

Listado 27.2. Sencillo juego expuesto como servicio Web 

< @ WebService Language="c#" Class="MyFirstWebService.GameWS" 


using System.Web.Services; 

namespace MyFirstWebService 

{ 

WebService (Namespace-"http: / / www .boutquin . com/GameWS / " ) ] 
public class GameWS : System.Web.Services.WebService 
{ 

// EJEMPLO DE SERVICIO WEB 

// El método Play() devuelve la cadena "Sorry, you lose!" 
// Para comprobar este servicio web, pulse F5 
[WebMethod] 

public string Play(string opponentName) 

{ 

return "Sony " + opponentName + ", you lose!"; 


} 


} 


Al construir un provecto de servicios Web en Visual Studio. se crea 
automáticamente un archivo de descripción de servicio que describe el servicio 
Web. Este archivo es un dialecto XML llamado Lenguaje de descripción de servi¬ 
cio Web (WSDL). Un archivo WSDL tiene este aspecto: 

<?xml version="1.0" encoding="UTF-8 " ?> 

cmethods href-'http: //www2 2 .bnnkster. com/bout quin/ 

GameWS.asmx '> 

<'method ñame-' Play' href = 'Play'> 

<r e ques t> 
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<param dt = ' string'>opponentName</paiam> 

</r equest> 

cresponse d t ='string' /> 

</method> 

< /me t. hods > 

WSDL describe las funciones que están expuestas (el formato que se muestra 
es en realidad una simplificación del formato real, pero los conceptos siguen 
siendo los mismos). 

Puede llamar al servicio mediante una URL (en este caso. www22. 
brinkster . com/bou t qu i n/ GameWS . asm:-: / P 1 a y ? oppo ne n t Ñame 

= Pierre) o enviar un mensaje XML con el formato apropiado a la URL (me¬ 
diante una instrucción post o get HTTP). Este mensaje XML puede ser un 
mensaje SOAP como el siguiente: 

<?xml ve rs ion-"1.0 " encoding-"ut. f - 8 " ? > 

< s oap:Enve 1 ope 

xmlns : xsi = "http: //w\w.w3 . or g/2 0 0 1 /XMLSchema-i ns t. anee " 

xmlns:xsd="http://www.w3.org/2001/XMLSchema" 

xmlns:soap= M http://schemas.xmlsoap.org/soap/envelope/"> 

< s oap:Body> 

<Play xmlns="http://www.boutquin.com/GameWS/"> 

< opp on e nt Ñame > Pie r re </opp on e n t Na me > 

</Play> 

</s o a p:Body> 

</soap:Enve1ope> 

Al invocar el servicio, mediante la URL o enviando un mensaje SOAP. se 
produce una respuesta XML como la siguiente: 

<?xml ve r s i on-" 1.0 " encoding="UTF-8 " ?> 

<st ring xmlns= "http://www.boutquin.com/GameWS/">S or ry P i e r r e , 

you lose!</string> 

Las siguientes secciones examinan las bases de SOAP y WSDL. tras lo cual 
pasaremos a estudiar los detalles de la creación e invocación de servicios Web. 

Lenguaje de descripción de servicio Web 
(WSDL) 


WSDL es el vocabulario XML usado para describir serv icios Web. Esta des¬ 
cripción incluye información sobre como acceder a ellos. NET Framevvork se 
ocupa de generar estos servicios Web por nosotros, de modo que no necesitamos 
saber demasiado sobre WSDL para usar servicios Web. Para ver el aspecto de un 
WSDL para un servicio puede añadir ?wsdl a su URL y ver el resultado en un 
navegador compatible con XML; por ejemplo, www2 2.brinkster.com/ 
boutquin/GameWS.asmx?wsdl. 


605 



Esta sección hace una breve descripción de este vocabulario XML. WSDL usa 
un espacio de nombre por defecto. xmlns="http://schemas. 
xmlsoap.org/wsdl/". Usa un elemento raíz llamado definitions y 
contiene varias secciones. Una de estas secciones es la sección de servicio donde, 
evidentemente, se describen los servicios. El siguiente fragmento es el esqueleto 
de un archivo WSDL. Un archivo WSDL real usa varias declaraciones de espacio 
de nombre, que aquí omitimos por simplicidad: 

<?xml version="1.0" encoding="UTF-8"?> 

< el e f i ni t i ons xmlns = ' http : / /schemas . xmlsoap . org/wsdl/' > 

""Service name = "GameWS" > 

<!--El servicio se describe aquí -*■> 

<■'/service > 

</de fin 1 1 1 on s > 

El primer atributo de una descripción de servicio define la posición desde la 
que se puede llamar al servicio. Esto se describe en el elemento address dentro 
de un elemento port. (Elemento y atributo son términos de XML. como puede 
ver en el apéndice.) El siguiente ejemplo muestra el atributo binding: 

< ?xrnl ver s ion= " 1 . O " encodmg-"UTF-8 " ?> 

< de finitions xmlns = ' http://schemas.xmlsoap.org/wsdl/'> 

"•'service ñame = " GameWS " > 

""'port. name = " GameWS S oap " binding= " s O : GameWSSoap" > 

<soap:address 

loeation="http://www22.brinkster.com/boutquin/GameWS.asmx" /> 

< / p o r t > 

</service> 

</d e finition s > 

Si un servicio Web está expuesto mediante una instrucción post o get de 
HTTP, su posición se almacena en un elemento http : address element: 

<port name="GameWSHttpPost" binding= "sO:GameWSHttpPost"> 

<rht tp : address location="http : //www22 .brinkster. com/bout qu i n/ 
GameWS . asmx'* /> 

</port> 

A continuación, debe definir los parámetros de entrada y salida. Puede hacerlo 
mediante los elementos de mensaje. En este elemento, se concede un nombre a 
cada mensaje; y en un mensaje, se describe cada parámetro (nombre y tipo de 
datos): 
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<: me s s a g e n ame - " P L a y I np u t. " .> 

< part ñame — " opponent Ñame " element-' zscl: st r ing / •* 

</me s s a g e> 

<message ñame ="PlayOutput" > 

<part ñameResult ' t ype =' ' xsd : s t r ing / -* 

</me s s a g e > 

A continuación puede asociar los mensajes con el punto final de destino usan¬ 
do un elemento portType. En portType. se usa el nombre que asignó a este 
punto final de destino en el elemento por t; y por cada uno de los servicios Web. 
crea una etiqueta de operación que contiene un elemento input y output que 
el mensaje usa como atributo: 

<portType name-"GameWSSoap"> 

Coperation ñame-"Play"> 

<input message = "PlayInput" / > 

<output message-"PlayOutput" /> 

</operation> 

</portType> 

Por ultimo, el elemento binding describe los detalles específicos importan¬ 
tes del mecanismo de transporte usado. Un enlace SOAP. por ejemplo, debe espe¬ 
cificar la acción de SOAP: 

<binding ñame-"GameWSSoap" type-"sÜ:GameWSSoap 
< s o a p:binding 

transporta" http: / /schemas . xmlsoap . org/s-oap/http" 
style="document" /> 

Coperation name="Piay"> 

esoap : operation s oapAct ion-" http : //www.boutqmn - com/ 

GameWS / Play " styl e- ,f document " /> 

<input > 

<soap:body use^"literal" /s 
</input > 

< output > 

<soap:body use- r M iteral " /> 

< / output. > 

</operation> 

</binding> 

Cómo usar el Protocolo de acceso simple 
a objetos (SOAP) 

SOAP es el dialecto de XML usado por los servicios Web. Especifica que 
acción de servidor quiere invocar para pasar la información (es decir, los 
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parámetros) al servicio Web. SOAP también especifica cómo se devuelve la in¬ 
formación desde el servicio Web (valores de devolución y excepciones). 

Los mensajes SOAP siguen un formato estándar: un sobre externo que identi¬ 
fica el mensaje como un mensaje SOAP. un cuerpo que contiene la principal 
carga útil v un titulo opcional que ofrece información adicional sobre el mensaje 
Puede usar el título para pasar información que no es una parte propiamente 
dicha de la invocación del servidor. Por ejemplo, puede pasar la fecha y hora de la 
solicitud o usar autentificación en este titulo. El cuerpo contiene un elemento 
cuvo nombre concuerda con el nombre del método del serv idor que se está invo¬ 
cando. 

Los elementos secundarios de este elemento tienen nombres que concuerdan 
con los parámetros: 

^?xm| version-" 1 . 0" encoding="utf-8"?> 

< soap:Enve 1 ope 

xmlns:xsi = "h11 p://www.w3-org/2001/XMLS chema-instanee" 
xmlns:xsd="http://www.w3.org/2001/XMLS chema" 
xmilis : soap-"http : / /schemas . xmlsoap . org/soap/envelope/"> 
ósoap:Header> 

• ! La información adicional se coloca aquí --> 

<' / soap : Heade r > 
s oap : Body > 

Me t hodName > 

Pa r amlName >value 1< /Par amlName> 

<•' Pa r am2 llame > va 1 ue 2 < / Pa r am2 Name > 

<! - etc. --> 

•' /MethodName > 

/ soap: Body > 

<■' / soap : En ve 1 ope > 


El mismo formato se usa para env iar una respuesta. Los nombres de parámetro 
(en este caso. ParamlName y Param2Name) de la respuesta son. por supues¬ 
to. los parámetros de salida; o "devolución" cuando el método sólo dev uelve un 
valor (por ejemplo <return>value < Vreturn>). 

Cuando se produce algún error, la información del error se env ia de v uelta en 
una sección de errores. La sección de errores se encuentra en el cuerpo SOAP: 


< s o a p:Fault> 


•' f a u 1 1 c o d e > x 0 0 < / f a u 11 c o d e > 

< f aul t s t r mg>descr ípt ion< fault s t ring> 

< ruñe ocie > Yes< runcode> 

<-/soap: F a u 11 > 
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Cómo crear servicios Web con Visual Studio 
.NET 


La operación de crear (v. en la siguiente sección, acceder a) un servicio Web 
usando Visual Studio NET es aparentemente simple. Ni siquiera sera consciente 
de estar usando XML 

El servicio Web que crearemos en esta sección simplemente recuperara y mos¬ 
trara una lista de libros. Esto simula la función de catálogo de una pagina Web 
comercial, aunque en el mundo real probablemente desearía introducir categorías 
para evitar que se devolviera una enorme lista de libros. Dado que el objetivo de 
este capítulo es mostrar los elementos necesarios para construir un serv icio Web. 
el aspecto comercial ha sido simplificado. 

El ejemplo que creamos aquí usa una tabla y un procedimiento almacenado. El 
codigo para crearlos aparece en el siguiente ejemplo (quizás también quiera colo¬ 
car algunos datos de muestra en la tabla Books): 

CREATE TABLE [Books] ( 

[ISBN] [char] (14) NOT NULL , 

[Title] [varchar] (150) NOT NULL , 

[Price] [money] NOT NULL 


GO 


ALTER TABLE [dbo].[Books] WITH NOCHECK ADD 

CONSTRAINT [PK_Books] PRIMARY KEY CLUSTERED 
( 

[ISBN] 

) ON [PRIMARY] 

GO 

CREATE PROCEDURE [ pe_getBooksf 
AS 

SELECT 

[ISBN] , 

[Title], 

[Price] 

FROM [Books] 

GO 

Ya esta preparado para construir un sencillo servicio Web que dev uelve una 
lista de libros usando el procedimiento almacenado: 

1. Abra Visual Studio .NET y seleccione Archivo>Nuevo proyecto. 

2. Seleccione Servicio Web ASP.NET como el tipo de proyecto en el cua¬ 
dro de diálogo Nuevo proyecto. 

3. Escriba BookSeller como nombre del provecto (véase la figura 27.2). 
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Figura 27.2. Un servicio Web es un tipo de proyecto 


4. Renombre el servicio Web de Servicel . asmx a Books . asmx. 

5. Cambie a Vista de código haciendo clic en la ficha Books . asmx . 
cambie todas las apariciones de Servicel a Books (figura 27.3) 
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Figura 27.3. Puede cambiar el nombre del servicio por defecto 
a uno más descriptivo 


6. Cambie la sección using para que contenga lo siguiente: 

usmg System; 

using System.Web.Services ; 


CS Y 
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using System.Data; 
using System. Data.OleDb; 

7. Agregue los siguientes métodos y propiedad a la clase Books: 

prívate static string oleDbConnectionString 


ge t 

{ 

// NOTA: Usar la cuenta sa en aplicaciones de 
producción 

// es, obviamente, una practica muy desaconsejable. 
Ademas, dejar la 

// contraseña para la cuenta sa en blanco es igualmente 
inadmisible. 

return "Provider =SQLOLEDB.1; " 

+"User ID-sa;Initial Cat alog-WebService 1_0_0;Data 
Sour ce=1 ocalhost ; " ; 


// EJEMPLO DE SERVICIO WEB 
[WebMethod] 

public DataSet getList() 

{ 

// Establece las cadenas de instrucción SQL 
string strSQLSelect = " [pc_getBooks ]" ; 

// Crea objetos OleDb 

01eDbConnection databaseConnection - new 
01eDbConne ction(oleDbConnectíonString) ; 

OleDbCommand selectCommand = new 
OleDbCommand(strSQLSelect, databaseConnection) ; 

OleDbDataAdapter dsCmd = new OleDbDataAdapter(); 

DataSet resultDataSet = new DataSet () ; 

// Estamos trabajando con un procedimiento almacenado (es 
decir, NO con un instrucción SQL) selectCommand.CommandType 
= CommandType.StoredProcedure ; 

t r y 

{ 

// Establezca la conexión a la base de datos 
databaseConnection.Open(); 

// Ejecute SQL Command 

dsCmd.SelectCommand = selectCommand; 

int numRows = dsCmd.Fill(resultDataSet, "Books"); 

} 

catch (Exception e) 

{ 


611 



Console.WriteLine ("** + *** Caught an exception:\n{0} " , 
e.Message) ; 

} 

f mal ly 
{ 

databaseConnection.Cióse(); 

} 


return resultDataSet; 

} 

La propiedad oleDbConnectionString contiene la cadena de co¬ 
nexión a la base de datos SQL Server. En código de producción, puede 
usar una cuenta con derechos de seguridad apropiados (y una contraseña) 
en lugar de la todopoderosa cuenta "sa". El método getList { ) abre una 
conexión a la base de datos SQL Server y recupera un conjunto de datos 
que contiene la lista de libros invocando al comando pc getBooks. 
Como puede ver. usar ADO.NET es muy sencillo. 

8 !Eso es todo! También puede agregar a la clase una declaración de espacio 
de nombre, como muestra el siguiente ejemplo: 

[WebService(Namespace="http://microsoft.com/webservices/")] 
public class Books : System.Web.Services.WebServíce 

Los espacios de nombre son un modo de evitar la duplicidad de nombres. 
Se usa un único prefijo para distinguir entre servicios Web con el mismo 
nombre. Por lo general, se usan direcciones URL como base para estos 
nombres únicos. Esto está en concordancia con el modo en que se usan las 
URL en los espacios de nombre XML. como se describe en el apéndice. 

9. Guarde el proyecto y pulse F5 para comprobar el servicio Web. 

Ahora que ha creado un servicio Web. intente crear una aplicación cliente que 
use este servicio Web. 

Cómo usar Visual Studio .NET para acceder 
a un servicio Web 

El siguiente ejemplo muestra los pasos necesarios para crear una aplicación de 
serv icio Web en C#: 

I Abra Visual Studio NET y seleccione Archivo>Nuevo proyecto. 

2. Seleccione Aplicación Web ASP.NET como el tipo de provecto. 

3. Déle al proyecto el nombre BookRetailer. 
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4. Seleccione Proyecto>Agregar referencia Web. 

5. Haga clic en Referencias Web en Servidor local para que Visual Studio 
.NET detecte automáticamente los servicios Web disponibles en el servi¬ 
dor local. 

6. Seleccione http: / /localhost/BookSeller/Boo k Se 11 e r 
. vsdisco y haga clic en Agregar referencia 

Ha importado la información necesaria para llamar a este servicio Web 

7. En el modo Diseño, agregue un control Label a la parte superior de la 
página y un control DataGrid bajo de la etiqueta y cambie a la vista de 
código. 

8. Agregue una declaración using a la página ASP.NET: esto indica al 
compilador que va a usar el código del servicio Web. 

using BookRetailer.localhost; 

9. Agregue el siguiente código al método Page_Init. En este ejemplo, se 
establece el texto Label y luego se rellena el DataGrid de un modo rápido 
y sencillo (esta página no ganará ningún premio por su apariencia): 

prívate void Page_Imt (object sender, EventArgs e) 

{ 

// 

// CODEGEN: ASP.NET Windows Form Designer necesita esta 
// 1lamada. 

// 

InitializeComponent(); 

// Agregado por PGB 
Labell.Text = "Available Books"; 

Books books = new BookRetailer.localhost.Books(); 

DataSet bookList = books.getList () ; 

DataGrid!.DataSource = 

bookList.Tables["Books"].DefaultView; 

DataGridl.DataBind(); 

// Fin de la adición PGB 

} 

10. Guarde y ejecute el proyecto (utilice F5 como tecla de método abreviado). 
Aparecerá una pantalla como la que se muestra en la figura 27.4. 

Reflexionemos sobre lo que hemos logrado Hemos creado un servicio Web 
(que puede ejecutarse en un servidor conectado a Internet). 

En esta sección, creó una página Web (que puede ejecutarse en un servidor 
diferente) que usa este servicio Web para recuperar una lista de libros del primer 
servidor 
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Figura 27.4. Un servicio Web en funcionamiento, tras haber recuperado una lista de 
libros del proveedor de servicio Web 


Resumen 

En este capítulo ha estudiado los estándares XML que hay tras los servicios 
Web, Vimos las dos tecnologías opcionales que toman parte en la definición de 
servicios Web: UDDI para el mecanismo de descubrimiento y WSDL para la 
descripción de servicio. También estudiamos el formato de mensaje que se usa 
durante la invocación real de un servicio Web: SOAP. Creamos un sencillo servi¬ 
cio Web usando Visual Studio Por último, creamos un segundo proyecto que 
usaba el servicio Web que había construido anteriormente. 
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28 


Cómo usar 


C# en ASP.NET 


La llegada de Internet y las intranets corporativas han llevado al desarrollo de 
las aplicaciones distribuidas. Una aplicación distribuida puede acceder a la infor¬ 
mación de diferentes fuentes de datos que pueden estar dispersas en varias locali¬ 
zaciones geográficas. 

Visual Studio NET lleva las aplicaciones distribuidas a nuevos niveles al 
permitirle usar serv icios Web y clientes de servicios Web. 

Los servicios Web de ASP.NET son servicios basados en XML que están 
expuestos en Internet y a los que tienen acceso otros servicios Web y los clientes 
de servicios Web. Un servicio Web muestra métodos Web a los que tienen acceso 
los clientes del serv icio Web. que implementan la funcionalidad del serv icio Web. 

Antes de Visual Studio NET. la programación ASP se realizaba usando 
VBScript. Sin embargo, con la llegada de Visual Studio .NET. puede usar dos 
lenguajes para la programación ASP: Visual CU y Visual Basic NET. 

Visual CU permite escribir codigo ASP.NET para servicios y aplicaciones 
Web. Por ultimo, aprenderá a implementar la aplicación Web mediante Visual 
Studio NET. 

En este capitulo, aprenderá a usar CU para crear aplicaciones ASP.NET. Em¬ 
pezaremos creando un serv icio Web en Visual CU. Tras ello, crearemos un cliente 
de serv icio Web en CU. que en realidad es una aplicación Web que usa el servicio 
Web 
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Cómo crear un servicio Web 


En Visual Studio NET. los servicios Web se usan para integrar las aplicacio¬ 
nes remotas con sus actuales soluciones comerciales. En líneas generales, los 
servicios Web presentan dos ventajas: 

• Puede usar un servicio Web de otra organización para crear una aplicación 
personalizada para su empresa. Por ejemplo, puede usar el servicio de 
autentifícación de Microsoft Passport para incluir esa autentificación en 
su página Web. Puede beneficiarse de este proyecto porque no necesita 
crear la infraestructura necesaria para implementar autentificación 
personalizada en su página Web. Además, su página podra atender a un 
mavor numero de visitantes porque todos los usuarios registrados con el 
servicio Passport (lo que incluye a todos los usuarios de Hotmail v MSN) 
podran conectarse a su página Web 

• También puede utilizar los servicios Web para comunicarse con sus com¬ 
pañeros de empresa. Por citar un ejemplo, imagine un vendedor de libros 
que tenga libros de varios editores. Si cada editor puede hospedar un servi¬ 
cio Web que proporciona información sobre los últimos libros que lia pu¬ 
blicado. el vendedor puede desarrollar un cliente de servicio Web que se 
conecte a estos servicios Web y recupere datos de estos libros. 

A continuación vamos a crear un serv icio Web que usa una base de datos Por 
tanto, en el primer paso aprenderá a crear una base de datos para el serv icio Web. 
A continuación, aprenderá a usar la base de datos y a crear el serv icio Web 


NOTA: Al crear el servicio Web de este ejemplo, nos concentraremos sólo 
en las tareas necesarias para crearlo. Para aprender más sobre los concep¬ 
tos que intervienen en la implementación de servicios Web, consulte un 
capítulo anterior. 


Cómo crear una base de datos para un servicio 
Web 

Los serv icios o aplicaciones Web suelen emplear una base de datos para alma¬ 
cenar sus datos pertenecientes a la aplicación En un entorno empresarial, las 
bases de datos, como Microsoft SQL Server y Oracle, están muy preparadas para 
gestionar datos. En el serv icio Web que creara en este capítulo se usa una base de 
datos SQL Server. Antes de crear la base de datos de SQL Scivei y las tablas 
para el servicio Web. revise los conceptos más importantes del Sistema de gestión 
de bases de datos relaciónales (RDBMS). 
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Conceptos del sistema de gestión de bases de datos 
relaciónales 

Un sistema de gestión de bases de datos relaciónales (RDBMS) es adecuado 
para las soluciones de negocios empresariales. Un RDBMS. como Microsoft SQL 
Server. Oracle o DB2. permite la creación, actualización y administración de 
bases de datos relaciónales. Una base de datos relaciona! es una colección de 
datos organizados en forma de tablas. Las aplicaciones pueden acceder a los 
datos de las tablas usando instrucciones de lenguaje de consulta estructurado 
(SQL). En un RDBMS. puede acceder a datos y reorganizarlos sin reorganizar 
toda la base de datos. Esto mejora considerablemente el rendimiento de la base de 
datos. Además, puede aplicar fácilmente reglas de negocios, validaciones y res¬ 
tricciones a los datos de las tablas de un RDBMS. Las reglas empresariales y las 
validaciones garantizan la integridad de los datos. Por ejemplo, cuando se inscri¬ 
be a un pasajero en un v uelo con el sistema de reservas de una compañía aerea, 
debe existir el numero de vuelo especificado. Puede determinar el numero del 
vuelo estableciendo una regla de negocio y usándola al reserv ar el billete. 

Tipos de datos de SQL Server 

Los datos de una base de datos se almacena en tablas, como filas y columnas. 
Las columnas de una tabla almacenan información clasificada, como el numero 
de identificación del producto, su nombre y el numero de unidades disponibles. 
Las filas de una tabla almacenan registros específicos. Cada columna de una 
tabla tiene un tipo de datos específico. La tabla 28 1 describe algunos de los tipos 
de datos SQL Server mas comunes. 

Tabla 28.1. SQL Data Types 


Tipo de dato 


Integer 


Fio a t 
o h a r i n f 


va r cbar(n) 


Descripción 


Se usa para almacenar números enteros. 

Se usa para almacenar números decimales. 

Se usa para almacenar datos de caracteres que pue¬ 
den ser alfabéticos, numéricos, caracteres especiales, 
como #, % o $, o una combinación de letras y caracte¬ 
res. Un tipo de dato char almacena un solo carácter. 
Para almacenar más de un carácter se usa char ín), 
donde n hace referencia al número de caracteres que 
se quieren almacenar. 

Se usa para almacenar datos de caracteres, donde n 
hace referencia al número de caracteres que se quie¬ 
ren almacenar. Un tipo de dato varchar es diferente 
de un tipo de datos char porque la memoria asignada 
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Tipo de dato 

Descripción 


a un tipo de datos varchar depende del tamaño de 
los datos, a diferencia de los tipos de datos char, en 
los que la memoria asignada está predefinida. 

Datetime 

Se usa para almacenar datos de fecha y hora. 

Money 

Se usa para almacenar datos monetarios que requie¬ 
ren gran precisión. 


TRUCO: Cada tabla debe tener al menos una columna que identifica 
unívocamente una fila (a la que llamaremos registro) de la tabla. Esta 
columna es la clave primaria de la tabla. Por ejemplo, la columna ProductID 
de una tabla Products identifica cada fila unívocamente y por tanto es la 
clave primaria. No puede haber dos valores iguales en una clave primaria. 


Cómo crear bases de datos y tablas 

Hn Microsoft SQL Server, se pueden crear bases de datos, tablas, procedi¬ 
mientos almacenados y consultas usando Transact-SQL (T-SQL) 


TRUCO: También puede usar SQL Server Enterprise Manager para crear 
una base de datos y tablas. SQL Server Enterprise Manager proporciona 
una interfaz gráfica para realizar los mismos pasos que realizamos median¬ 
te las instrucciones T-SQL. 


Para crear una base de datos o una tabla mediante T-SQL. se emplea la ins¬ 
trucción Crcate Por ejemplo, para crear una base de datos Sales, escriba el 
siguiente codigo en la v entana del analizador de consultas: 

Create Database Sales 

Tras crear la base de datos, puede agregarle tablas. Agregue la tabla Products 
a la base de datos Sales mediante la siguiente sintaxis: 

Create Table Products 
( 

ProductID VarChar (4) Primary Key, 

ProductName VarChar (20), 

UmtPrice Integer, 

QtyAvai1able Integer 
) 
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Cómo recuperar datos 

Puede recuperar información almacenada en tablas usando la instrucción 
Select. Por ejemplo, para recuperar todos los registros de la tabla Products de 
la base de datos Sales, use las siguientes instrucciones: 

Use Sales 

Select k From Products 

Cómo insertar, actualizar y eliminar datos 

Puede agregar, actualizar v eliminar datos de una base de datos de SQL Server 
siguiendo los pasos indicados a continuación: 

• Agregar un registro: Para agregar una nueva fila a una tabla SQL Server, 
use la instrucción Insert. Por ejemplo, para agregar un nuevo registro a 
la tabla Products, se usa la siguiente instrucción: 

Insert luto Products (ProductID, ProductName, UnitPrice, 

Q t y A v a 1 1 a b 1 e ) 

Valúes ( 'P001' , 'Baby Food' , 2.5, 12000) 


ADVERTENCIA: Para que la inserción tenga éxito, los valores de la co¬ 
lumna deben proporcionarse en el mismo orden que las columnas de la 
tabla. Además, si el tipo de datos de una columna es char, varchar o 
datetime, debe especificar los valores entre comillas. 


• Modificar un registro: Para modificar un registro de una tabla SQL Server, 
use la instrucción Update: 

Update Products 
Set UnitPrice=75 
Where ProductID-"P010" 

El anterior codigo actualiza el precio por unidad del registro cuya identifi¬ 
cación de producto es P010 hasta 75. 

• Eliminar un registro: Para eliminar un registro de una tabla, use la ins¬ 
trucción De le te. Por ejemplo, para eliminar un registro de la tabla 
Products con la identificación de producto P01 1. puede especificar la si¬ 
guiente instrucción: 

Delete From Products where ProductID="Pü11" 

Cómo usar procedimientos almacenados 

Un procedimiento almacenado es un conjunto de instrucciones SQL usadas 
para realizar tareas específicas. Un procedimiento almacenado se aloja en un 
Servidor SQL y puede ser ejecutado por cualquier usuario que tenga los permisos 
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adecuados. Puede crear un procedimiento almacenado usando la instrucción 
Create Procedure. Use el siguiente código para crear un procedimiento 
almacenado que acepte ProductID como parámetro y devuelva el precio por uni¬ 
dad del registro que concuerde con el ProductID: 

Create Procedure ProductPrice (@id char (4)) 

As 

Select UnitPnce 

From Products Where ProductID=@id 

Return 

El procedimiento requiere un parámetro. @id. en el momento de la ejecución. 

Los procedimientos almacenados son particularmente útiles cuando se necesi¬ 
ta realizar varias tareas consecutivas en una base de datos. Por ejemplo, cuando 
quiere cancelar la reserva de un pasajero, querrá calcular la tarifa que debe de¬ 
volverse al cliente y borrar su reserva de la tabla de reservas. Al mismo tiempo, 
también deberá actualizar el estado de los otros pasajeros que puedan estar en 
lista de espera para entrar en la lista de pasajeros. En lugar de especificar consul¬ 
tas de SQL cada vez que quiera cancelar una reserv a. puede usar un procedimien¬ 
to almacenado para cancelar la reserva de un pasajero. 


ADVERTENCIA: Cada procedimiento almacenado debe terminar una ins¬ 
trucción Return. 


Para ejecutar el procedimiento anterior para que muestre el precio del produc¬ 
to con la identificación ID PO 10. use el siguiente código: 

Ezecute ProductPr ice ” P 010" 

Cómo crear la estructura de la base de datos 

En este capitulo, necesitamos crear una base de datos Sales para nuestro servi¬ 
cio Web Tras crear la base de datos Sales, agregue una tabla Products a la base 
de datos. Para crear una base de datos Sales y añadirla la tabla Products, siga los 
siguientes pasos: 

1 . Seleccione lnicio>Programas>Microsoft SQL Server>Query Analyzer 
Se abrira el cuadro de dialogo Connect to SQL Server. 

2. En el cuadro de dialogo Connect to SQL Server, escriba el nombre 
del servidor SQL en el cuadro de texto SQL Server, especifique un nombre 
de contacto en el cuadro de texto Login Ñame y especifique la contrase¬ 
ña para el nombre de contacto en el cuadro de texto PassworcL 

3. Haga clic en OK para conectarse al SQL Serv er y abra el editor de consul¬ 
tas. 
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4 En el editor de consultas, introduzca las siguientes instrucciones para crear 
la base de datos Sales y agregar la tabla Products a la base de datos: 

Create database Sales 
GO 

Use Sales 

Create Table Products 
( 

ProductID VarChar (4) Primary Key, 

ProductName VarChar (20), 

UnitPrice Integer, 

QtyAvailable Integer 
) 

GO 

5. Selecciono Query>Execute para ejecutar la consulta. 

Tras ejecutar la consulta, la estructura de la base de datos esta creada. Ahora 
estamos listos para crear el servicio Web (la primera de las aplicaciones ASP NE1 
que creará este capítulo). El servicio Web que se crea en este capítulo agrega 
registros a la tabla Products de la base de datos Sales que creamos anteriormente 
en esta misma sección. 

Cómo usar la plantilla Servicio Web ASP.NET 

Debe usar la plantilla de proyecto Servicio Web ASP.NET para crear un 
servicio Web. Este proyecto sirve como plantilla basada en la Web para crear los 
componentes del servicio Web Para crear un servicio Web. siga estos pasos: 

I Seleccione Archivo>Nuevo>Proyecto para abrir el cuadro de dialogo 
Nuevo proyecto. 


TRUCO: Puede pulsar simultáneamente las teclas Control-Mayús-N para 
abrir el cuadro de diálogo Nuevo Proyecto. 


2 Seleccione Proyectos de Visual C# de la lista Tipos de proyecto 

3. Seleccione Servicio Web ASP.NET del cuadro de plantillas a la derecha 
del cuadro de dialogo 

4 En el cuadro Nombre. escribaOrdersWebService. En el cuadro Ubi¬ 
cación. introduzca el nombre de su servidor Web como http:/ / 
<nornbredeservidor>. Haga clic en Aceptar. 


TRUCO: También puede escribir localhost en el cuadro Ubicación si el 
servidor Web está instalado en el equipo en el que está creando el servicio 
Web. 
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NOTA: Puede que tenga que esperar bastante tiempo mientras Visual Studio 
NET crea el servicio Web. 


Una vez que Visual Studio NET ha creado el servicio Web. puede configurar¬ 
lo para que gestione datos en el servidor. Esto lo haremos en la siguiente sección 

Cómo agregar controles de datos al servicio Web 

Debe agregar controles de datos al servicio Web para permitir la comunica¬ 
ción con la base de datos Sales que creo en el anterior apartado. Para comunicarse 
con la base de datos, debe agregar los siguientes controles a su servicio Web: 

• Sql DataAdapter: El control Sql DataAdapter se usa para trans¬ 
ferir datos entre fuentes de datos. 

• SqlConnect ion y Sql Da taAdapter : Los controles SqlData- 
Adapter y SqlConnect ion se usan para conectar con la origen de 
datos. 

• SqlCommand: Tras establecer una conexión con el origen de datos, use el 
control OleDbCommand para acceder a los datos. 

• DataSet: Los datos se almacenan en un control Data Set. 

Los pasos para agregar el control SqiDataAdapter son los siguientes: 

I Seleccione Ver>Cuadro de herramientas para abrir el cuadro de herra¬ 
mientas. 

2. En el cuadro de herramientas, haga clic en Datos para activar la ficha 

Datos. 

3. Arrastre el control SqiDataAdapter desde el cuadro de herramientas 
hasta el Diseñador de componentes. 

4. Al arrastrar el control SqiDataAdapter desde el cuadro de herramien¬ 
tas. se inicia el asistente para la configuración del adaptador de datos. En 
la pantalla de bienvenida del asistente, haga clic en Siguiente 

5 Aparecerá el cuadro de dialogo Elegir la conexión de datos del asisten¬ 
te. como se ilustra en la figura 28.1. Llaga clic en Nueva conexión para 
crear una nueva conexión usando el controlador OleDbDataAdapter. 

6. Se abnra el cuadro de dialogo Propiedades de vínculo de datos. Por 
defecto, este cuadro de diálogo tiene seleccionada la ficha Conexión Es¬ 
pecifique el nombre del servidor SQL en el cuadro de diálogo Seleccione 
o escriba un nombre de servidor. 
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Eleqir la ronexion de datos 

E 1 adaptador do dato;- oiocutara r 
cargar y actualizar datos. 


Elegir en la lista de conexiones de datos que están actualmente en el Explorador de 
servidores o agregar una nueva conexión si la que desea no aparece en la lista. 


¿Qué conexión de datos debería utilizar el adaptador de datos? 


Figura 28.1. El cuadro de diálogo Propiedades de vínculos de datos 

Seleccione el nombre de usuario y la contraseña para conectarse al servi¬ 
dor SQL Server y seleccione la base de datos Sales en la lista desplegable 
Seleccione la base de datos en el servidor La figura 28 2 muestra la 
pantalla Propiedades de vínculos de datos completa. Haga clic en 
Aceptar 


Proveedor Conexión | Avanzadas j T odas | 

Especifique lo siguiente para conectarse a datos de SQL Server: 

1 Seleccione o escriba un nombre de servidor: 

|NPANDÉ? DI85 Actualizar | 

2. Escriba la información para iniciar sesión en el servidor: 

O Usar la seguridad integrada de Windows NT 

Usar un nombre de usuario y una contraseña específicos: 
Nombre de usuario: fia 


W Contraseña en blanco W Permitir guardar contraseña 
Seleccione la base de datos del servidor: 


Adjuntar archivo de base de datos como nombre 


Probar conexión 


Figura 28.2. Conecte con el origen de datos usando el cuadro de diálogo 
Propiedades de vínculo de datos 
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8. El adaptador de datos que ha configurado aparecerá en el cuadro de dialo¬ 
go Elegir la conexión de datos. Haga clic en Siguiente para continuar. 

P. Se abrirá el cuadro de diálogo Elegir la conexión de datos. Para usar 
una consulta SQL para recuperar datos de la base de datos, mantenga la 
opción por defecto. Usar instrucciones de SQL y haga clic en Siguien¬ 
te 

10. Se abrirá el cuadro de dialogo Generar las instrucciones SQL. En este 
cuadro de dialogo, escriba la consulta Select * from Products y haga clic 
en Siguiente 

1 1 Se abrirá el cuadro de dialogo Ver resultados del asistente. Este cua¬ 
dro de dialogo resume las opciones que ha seleccionado en los anteriores 
cuadros de diálogo del asistente. Haga clic en Finalizar para dar por fina¬ 
lizado el asistente de configuración del adaptador de datos. 

Tras completar el asistente de configuración del adaptador de datos, el control 
S q 1E') a t a A d a pter esta configurado para su aplicación Como se puede apre¬ 
ciar en la figura 28.3. los controles sql DataAdapter 1 y sqlConnect ion!; 
se han agregado a su aplicación. 


«C OrderWebSenrice - Microsoft Visual C# JHET {dbeflarj 
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Figura 28.3. Los controles sqlDataAdapterl y sqlConnectionl se han agregado a su 

aplicación 


A continuación, agregue el control SqlCommand al servicio Web. El control 
Sql Cornmand se usa para especificar comandos que necesitan ser ejecutados en 
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el origen de datos. Siga estos pasos para agregar un control SqlCommand a su 
aplicación: 

1. Arrastre el control SqlCommand desde el cuadro de herramientas al 
diseñador de componentes. 

2. Abra la ventana Propiedades y seleccione sqlConnect ionl para la 
propiedad de conexión del control SqlCommand. 

A continuación, debe generar un conjunto de datos para almacenar los datos 
que recuperen los controles de datos: 

1. Para generar el conjunto de datos, seleccione el control SqlCommand! 
que agregó en los pasos anteriores y seleccione la opcion de menú 
Datos>Generar conjunto de datos 

2. Se abrirá el cuadro de dialogo Generar conjunto de datos En este 
cuadro de dialogo, ya esta seleccionada la tabla Products de la base de 
datos. Seleccione la casilla Agregar este conjunto de datos al 
diseñador y haga clic en Aceptar para generar el conjunto de datos y 
agregarlo al diseñador de componentes. 

Los cuatro controles que ha agregado al servicio Web ahora son v isibles para 
el diseñador de componentes. Ahora necesita codificar los métodos del servicio 
Web. como verá en la siguiente sección. 

Cómo codificar el servicio Web 

Tras agregar los controles de datos al servicio Web. debe codificar los méto¬ 
dos del sen icio Web. En este capítulo le enseñamos a codificar un método para 
agregar productos a la base de datos Products mediante el servicio Web 

Antes de proceder a codificar los métodos del servicio Web. añádales una 
descripción y cambie el espacio de nombres por defecto del servicio Web La 
descripción y el espacio de nombres del servicio Web permiten al desarrollador 
del cliente del servicio Web entender el modo de empleo del servicio Web. Para 
agregar una descripción y cambiar el espacio de nombres por defecto asociado al 
servicio Web. siga estos pasos: 

1. Haga doble clic en el diseñador de componentes para abrir el editor de 
código. 

2. En el editor de código, localice la instrucción public clrjss Serví col. 

3. Agregue el siguiente codigo antes de la instrucción que localizo en el se¬ 
gundo paso: 

[ WebS e r v i cc (Ñame y pace - "http: //Se r v i ce URL . cora/ produce s / " , 

Dése r ípt i on- " Us e t he servicio Web t. o a cid produces Do t he 
S a1es da t aba s e."|1 
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Tras introducir la linca de código anterior, el espacio de nombres del servicio 

Web es http : / /ServiceURL . com/products/ y se ha agregado una des¬ 
cripción al sen icio Web. 

A continuación, escriba el codigo para agregar productos a la tabla Products 
Este código necesita escribirse justo debajo de la declaración del servicio Web. El 
codigo del método AddProduct. que agrega detalles del producto a la tabla 
Products, es el siguiente: 

[WebMethod(Description="Specify the product ID, product ñame, 

unit pnce, and quantity t o add it to the Sales catalog”)] 

pubi ir; strinq AddProduct (strmg PID, string ProductName, int 

Pnce, int Qty) 

I 

t r y 
{ 

P r o d u c t N a me = P r o d u c; t N a me . T r i m { ) ; 

íí ( P r i ce*": 0 ) 

return "Please specify a va 1 1 d valué for pnce"; 

if ÍQtyO} 

return "Please specify a valid valué for quantity"; 

sq 1Connect.ionl . Open 11 ; 

sqK:ommand|i CommandTex t - " INSEP.T INT O Product s (Product I fl, 

ProductName, UnitPrice, QtyAvailable) VALUES ('" + PID t 

" ', f ProductName + " ', '" + Pnce + " ' , '" + Qty 

+ 

" ' i " ; 

s q1C ommand1.ExecuteNonQuery() ; 

s q 1 C o nnectionl .Cióse ( i ; 

return "Record updated suceessful1y"; 

) 

c a t c h ( E c e p 1 1 o n e i 

i 

retu rn e.Message; 

} 

¡I 

El codigo anterior usa el control sqlConnectionl para agregar un regis¬ 
tro a la tabla Products. Al agregar registros a un servicio Web. se usan los 
valores que la función AddProduct proporciona como parámetros. 

Mientras codifica el método AddProduct del servicio Web. puede codificar 
otros métodos para recuperar detalles de producto de la base de datos Products o 
realizar otras acciones personalizadas. Para probar el servicio Web tras agregarle 
los métodos, siga estos pasos: 

1 Seleccione Generar>Generar solución para generar el servicio Web. 

2. Para empezar a depurar el servicio Web. seleccione la opcion de menú 
Depurar dniciar 

El servicio Web se abre en Internet Explorer. El primer cuadro de diálogo 
muestra los métodos que codifico para su servicio Web. 
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Para comprobar el método AddProduct. siga estos pasos: 

I Haga clic en AddProduct en el cuadro de dialogo Servicio Web Service 1 

2. Se abrirá el cuadro de dialogo AddProduct. como muestra la figura 28 4 
En este cuadro de diálogo, puede invocar la función AddProduct tras 
proporcionar los parámetros requeridos para probar su resultado 
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Figura 28.4. Especifique los parámetros para la función AddProduct para 

comprobarla 


3. Escriba P002. PDA. 100 \ 200 como los parametros para el P1D. 
ProductName. Pricc y Qty respectivamente y haga elíe en Invoke para 
probar su resultado. 

4. Cuando se logra agregar el registro al servicio Web. se consigue un insul¬ 
tado como el que se muestra en la figura 2 K. A 

Tras probar su servicio Web. puede crear un cliente de servicio Web para 
acceder al servicio Web 

Cómo crear un cliente de servicio Web 

Un cliente de servicio Web de ASP.NET es una aplicación Web compuesta pol¬ 
lino o más WebForms En esta sección, vamos a crear una aplicación Web 
ASP.NET que accede al servicio Web creado en la anterior sección 







Figura 28.5. Este resultado se consigue cuando se logra agregar un registro 

a un servicio Web 


Para crear un cliente de servicio Web solo tiene que seguir estos pasos: 

1 Cree un nuevo proyecto de Aplicación Web ASP.NET. 

2. Agregue una referencia Web a la aplicación Web. 

3. Implemento los métodos del servicio Web en la aplicación Web 

La siguiente sección estudia detenidamente cada uno de estos pasos. 

Cómo crear un nuevo proyecto de aplicación 
Web ASP.NET 

Para crear un provecto de aplicación Web. siga esto pasos: 

1 Seleccione la opción de menú Archivo>Nuevo>Proyecto. Se abrirá el 
cuadro de dialogo Nuevo proyecto. 

2. En el cuadro de dialogo Nuevo proyecto, seleccione la plantilla de pro¬ 
vecto Aplicación ASP.NET de la lista Provectos de Visual C#. 

3. Escriba O r d ersW e^b Appjp. catión como nombre del provecto y haga 
clic en Aceptar para crear la aplicación Web. 




Cómo agregar una referencia Web 

Tras crear el servicio Web. necesita agregar una referencia Web al serv icio 
Web que creó en la anterior sección. Al agregar una referencia Web. el cliente de 
servicio Web descarga la descripción del serv icio Web y crea una clase de proxv 
para el serv icio Web. Una clase de proxv incluye funciones para los métodos del 
servicio Web. Para agregar una referencia Web al serv icio Web. siga estos pasos: 

1 Seleccione el formulario Web WebForml . asp:-: y a continuación selec¬ 
cione la opcion de menú Proyecto>Agregar referencia Web. Se abrirá 
la opción de menú Agregar referencia Web 

2. En el cuadro de dialogo Agregar referencia Web. haga clic en Referen¬ 
cias Web en el v ínculo Servidor Web local. Los servicios Web disponi¬ 
bles en el servidor Web local aparecerán en la lista Referencias 
disponibles, como muestra la figura 28.6. 

3. En el cuadro de dialogo Agregar referencia Web. seleccione el vínculo 
al servicio Web OrdersWebService y haga clic en Agregar referen¬ 
cia para agregar una referencia al servicio Web. 
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Figura 28.6. Los servicios Web disponibles se muestran en el cuadro de diálogo 

Agregar referencia Web 


La referencia al servicio Web que se agrega aparece en el explorador de solu¬ 
ciones. Por defecto, recibe el nombre localhost. Puede cambiar el nombre del 
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serv icio Web por un nombre de su elección. En la figura 28.7. recibe el nombre 
OS I 
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Figura 28.7. Las referencias a servicios Web aparecen en el Explorador 

de soluciones 


Cómo ¡mplementar los métodos del servicio Web 

Para implementar los métodos del servicio Web. necesita diseñar un WebForm 
FJ WebForm acepta información que debe añadirse a la base de datos Sales. F1 
WebForm diseñado para la aplicación Web aparece en la figura 28.8. 
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Figura 28.8. Diseño de un WebForm que acepta información de los usuarios 


Para diseñar el formulario, puede agregar los controles que aparecen en la 
tabla 28.2. 

Tras diseñar el WebForm. escriba el codigo para el exento Click del botón 
Submit. ( uando el usuario haga clic en el botón Submit. el codigo del exento 
O ; i k hará lo siguiente: 
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1. Creará una instancia del sen icio Web 

2. Llamará al método AddProduct del servicio Web. pasando como 
parametros al WebForm los valores introducidos por el usuario. 

Tabla 28.2. Controles de formularios Web 


Tipo de control 

Propiedades cambiadas 

Lab e.l 

Se ha agregado seis etiquetas: el encabezamiento 
principal de la página, Product ID, Product Ñame, 
Price, Quantity y Message, respectivamente. Se ha 
cambiado el Id. de la última etiqueta a LabelMessage 
y se ha limitado su texto. 

Text Box 

ID= PID 

Text Box 

ID=ProductÑame 

T e x t; B o x 

T D = Price i 

Text Box 

'¿¿D - Quantity 

Button 

TD=Submit 


Text=Submit ; 

3. Mostrará el valor devuelto desde el método AddProduct en la etiqueta 

LabelMessage. 

A continuación se muestra el código del evento Click del botón Submit 
que cumple las tareas indicadas anteriormente: 

TRUCO: Para introducir el código del evento Click del botón Submit, 
haga doble clic en el botón Submit en la vista diseño. 


prívate void Submi t_Click(object sender, System.EventArgs e) 

{ 

OSl.Servicei Webl-new OS 1.Service! () ; 

LabelMes s a ge.Text = Web1.AddP r oduct (PID.Te xt, 
ProductName.Text, 

Convert . ToInt32 (Pnce.Tet) , Convert . Tolnt 3 2 
(Quantity.Text)); 

} 

4. Seleccione Depurar>lnicio para ejecutar el servicio Web El resultado de 
la aplicación Web aparece en la figura 28.9. 

Especifique valores en los cuadros de texto Product ID. Product Ñame, Price y 
Quantity y haga clic en Submit. La aplicación Web agregará la información 
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Cómo implementar la aplicación 

El ultimo paso para integrar varias aplicaciones de Visual Studio NET es 
implementar la aplicación que ha construido. Para implementar la aplicación, 
puede usar uno o más proyectos proporcionados por Visual Studio NET. Las 
siguientes secciones estudian la implemcntación de provectos proporcionada por 
Visual Studio NET y describen los pasos necesarios para implementar una apli¬ 
cación ASP.NET. 

Implementación de proyectos en Visual Studio 
.NET 

Visual Studio NET proporciona cuatro tipos de provectos de instalación: Pro¬ 
vectos Cab. Provectos de módulos de combinación. Proyectos de instalación y 
Provectos de programas de instalación Web. La siguiente lista describe estos 
tipos de prov ecto: 

• Proyectos Cab: Puede crear un archivo contenedor (CAB) para empaque¬ 
tar controles ActiveX. Cuando empaqueta un control ActiveX en un archi¬ 
vo CAB. el control puede descargarse desde Internet. 

• Proyectos de módulos de combinación: Puede crear un módulo de combi¬ 
nación para los componentes de aplicación que quiera incluir en varias 
aplicaciones. Por ejemplo, un control de servidor que haya creado puede 
ser empaquetado como un provecto de módulo de combinación que puede 
incluir en provectos de instalación para sus aplicaciones de Windows. 

• Proyectos de instalación: Puede usar un provecto de instalación para 
empaquetar aplicaciones de Windows. Un provecto de aplicación crea un 
archivo Microsoft Installer (MSI) que puede usarse para instalar una apli¬ 
cación en el equipo de destino. 

• Proyectos de programas de instalación Web: Puede usar la plantilla 
Provecto de programa de instalación Web para una aplicación Web 
ASP.NET o para un serv icio. 

La siguiente sección describe como crear un prov ecto de implementación para 
una aplicación Web ASP.NET. 

Cómo usar un proyecto de implementación para 
implementar una aplicación 

Los pasos necesarios para implementar una aplicación ASP NET son los si¬ 
guientes: 
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1 . En el Explorador de soluciones, haga clic en la solución OrdersWeb- 
Appl ication. Desde el menú emergente que aparece, seleccione 

Agregar>Nuevo proyecto. 

2. En el cuadro de diálogo Nuevo proyecto que se abre, seleccione Proyec¬ 
tos de instalación e implementación en el cuadro Tipos de proyecto 

3. En el cuadro Plantillas, seleccione Proyecto de programa de instala¬ 
ción Web. Escriba como nombre del provecto WebSetupDeploy y haga 
clic en Aceptar El nuevo proyecto se agregará a la ventana del explorador 
de soluciones. Por defecto, se abre el Editor del sistema de archivos 
para el provecto de implementación. El Editor del sistema de archivos 
le ayuda a agregar archivos al proyecto de implementación. 

4. En el Editor del sistema de archivos (el cuadro a la izquierda), selec¬ 
cione Carpeta de aplicación Web 

5. Para agregar el resultado de OrderWebApplication al proyecto de 
implementación. seleccione Acción>Agregar>Resultados de proyec¬ 
tos. Se abrirá el cuadro de diálogo Agregar grupo de resultados del 
proyecto 

6. En el cuadro de dialogo Agregar grupo de resultados del proyecto, 
seleccione OrderWebApplication en la lista desplegable Proyectos, si es 
necesario. 

7. Mantenga presionada la tecla Control y seleccione Resultado principal 
v Archivos de contenido de la lista de archivos. Las opciones seleccio¬ 
nadas aparecen en la figura 28.1 1 
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Figura 28.11. El cuadro de diálogo Agregar grupo de resultados del proyecto muestra 

las opciones que ha seleccionado 
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8. Haga clic en Aceptar para cerrar el cuadro de diálogo Agregar grupo de 
resultados del proyecto 

9. En la ventana del editor del sistema de archivos, haga clic con el boton 
derecho del ratón en la Carpeta de aplicación Web. En el menú desple¬ 
gable. seleccione la ventana Propiedades para abrir la ventana Propie¬ 
dades. 

10. Escriba OrderWebApplication como nombre del directorio virtual en la 
propiedad VirtualDirectory y cierre la ventana Propiedades 

I 1 Seleccione la opción de menú Generar>Generar solución. 

Se ha creado un archivo Microsoft Installer (MSI) para su proyecto Puede 
hacer doble clic en el archivo para instalar su aplicación en un equipo. 

Cómo implementar un proyecto usando 
la opción Copiar proyecto 

Si no quiere tomarse la molestia de crear un provecto de implementación para 
su aplicación y usar el proyecto para implementarla. también puede usar la op¬ 
ción Copiar proyecto de Visual Studio NET para copiar todos los archivos de 
su aplicación en la carpeta de destino. 

La opcion Copiar proyecto es útil cuando necesita implementar un proyecto 
en una red de comunicaciones. Sin embargo, esta opción no funciona cuando 
quiere implementar su aplicación en un equipo remoto que no tiene acceso a la red 
de comunicaciones. 

Para usar la opción Copiar proyecto, siga estos pasos: 

1. Abra el proyecto que quiere copiar. 

2. Seleccione la opcion de menú Proyecto>Copiar proyecto Se abnra el 
cuadro de diálogo Copiar proyecto. 

3. Especifique en el cuadro de dialogo la Carpeta de provecto de destino, la 
ruta de destino en la que quiere copiar el provecto. 

4. Seleccione los archiv os del prov ecto que quiere copiar y haga clic en Acep¬ 
tar. Su prov ecto se copiará en el destino que especificó en el Paso 3. Tras 
copiar el prov ecto, puede ejecutarlo desde la nueva ubicación 


Resumen 


El papel do C# en ASP.NET es muy útil para los servicios y aplicaciones Web. 
Puede crear un servicio Web mediante la sintaxis del lenguaje C# en ASP.NET, 
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También puede crear una aplicación Web que acceda al servicio Web y aproveche 
su funcionalidad. 

Cuando crea una aplicación en ASP.NET, primero diseña la base de datos que 
debe usar la aplicación. A continuación, crea un nuevo proyecto en ASP.NET 
mediante la Aplicación Web de ASP.NET o las plantillas de proyecto servicio 
Web ASP.NET. 

Tras crear un proyecto en ASP.NET. use los controles de datos proporciona¬ 
dos por Visual Studio NET para conectar con un origen de datos y utilizarlo. 

Si ha creado un servicio Web. también puede crear una aplicación Web para 
utilizar los métodos Web proporcionados por el servicio Web. 
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29 


Cómo 
construir 
controles 

personalizados 


En este capítulo aprenderá a crear controles personalizados. Estos controles 
pueden tomar la forma de un componente visible que puede agregarse a un formu¬ 
lario o simplemente ser un objeto de clase encapsulado en una DLL. En cada 
instancia, estos controles aprovechan su conocimiento de la reutilización de códi¬ 
go cuando empieza a empaquetar y distribuir la funcionalidad como un control 
que puede ser usado una y otra vez. 

Biblioteca de control de Windows 

Una biblioteca de control de Windows es un proyecto que permite la creación 
de componentes iguales que los mostrados en el cuadro de herramientas de Visual 
Studio. Hace años, estos controles eran siempre objetos COM o controles ActiveX 
Ahora puede agregar componentes COM al cuadro de herramientas o puede crear 
un control que tenga la forma de una biblioteca de vínculos dinámicos (DLL). 

Las anteriores versiones de Visual Studio tenían asistentes que axudaban en la 
creación de controles y Visual Studio NET no es diferente. Las tareas asociadas 
con la creación de propiedades, métodos y campos se han simplificado gracias a 
la inclusión de los asistentes. 



Propiedades 


Las propiedades se usan principalmente para establecer y recuperar parámetros 
de control. Cuando a las propiedades se le conceden los accesos de lectura y de 
lectura v escritura, se componen de dos funciones llamadas get y set. Dado 
que una propiedad debe llamar a un método cuando se le asignan o se recuperan 
de ella valores, puede realizar cálculos u otras funciones útiles inmediatamente. 
En este aspecto, son muy diferentes de los campos Un ejemplo de propiedad 
puede ser la propiedad BackColor. Al usar esta propiedad, puede especificar el 
color que se va a usar como color de fondo de un control o comprobar cual es el 
actual color de fondo. 

Las propiedades se implementan fácilmente en un proyecto usando el sencillo 
asistente de Visual Studio NET. En la ventana Vista de clases, haga clic con el 
botón derecho del ratón en la clase del control y escoja Agregar>Agregar clase 
El asistente, que aparece en la figura 29. 1. le permite establecer el tipo de acceso, 
el tipo de propiedad (int. bool y similares), el nombre de la propiedad, los 
descriptores de acceso y los modificadores. 


Asistente para propiedades de C# - CountOown 


m 


üj 


Asistpnte para agregar propiedades de C# 

F-'.te asistente agrega una propiedad a la clase de 


Acceso a la propiedad: 


Tipo de propiedad: 


Descriptores de acceso: 

C get C set (• get/set 
Modificadores de la propiedad: 

(*' Ninguno Static C Virtual C 

Comentario (notación // no requerida): 



Nombre de propiedad: 




Ayuda 


Figura 29.1. El asistente para agregar propiedades permite agregar una propiedad 

a su proyecto 


Tras terminar con el asistente, verá el armazón de codigo para la propiedad: 

publie int Tes t Pr ope rty 
{ 

get 


return 0; 


s e t 
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{ 

} 

} 

En este código faltan algunos elementos básicos. Cuando se establece el valor 
de una propiedad, la información no se almacena. Debe crear antes una variable 
de clase privada que pueda ser usada por esta propiedad para almacenar y recupe¬ 
rar el valor. En este caso, simplemente debe incluir la siguiente declaración en la 
parte superior de su declaración de clase: 

prívate int m TestProperty; 

Desde el método set de su propiedad, puede asignar los datos de su variable 
privada usando la palabra clave valué: 

set 

{ 

m TestProperty = valué; 

} 

Una vez que hemos almacenado el valor de la propiedad en la variable de clase 
privada, debe asegurarse de que el método Get devuelve el valor correcto al ser 
usado. El siguiente codigo logra esto; simplemente devuelve el valor de la varia¬ 
ble privada del bloque get. como muestra el siguiente fragmento: 

get 

{ 

return m_TestProperty 

} 

También es útil describir las propiedades de los componentes existentes en su 
control. Por ejemplo, imagine que ha creado un control que contiene una etiqueta. 
Su control debe contener una propiedad Font que obtenga y establezca la fuente 
del componente de la etiqueta de su control. Para permitir que el contenedor 
manipule la fuente de su etiqueta, simplemente cree una propiedad como la si¬ 
guiente: 

public Font CurrentFont 

{ 

get 

{ 

return 1abe11.Font; 

} 

set 

{ 

labell.Font - valué; 

} 


Este código crea una propiedad llamada CurrentFont. que devuelve la 
fuente actual del control label cuando se le solicita. Cuando el contenedor 



desea cambiar la fuente, simplemente tiene que asignar ese valor a la fuente actual 
del control de la etiqueta 

Métodos 

Un método se define como una función que forma parte de una clase. Los 
métodos se implementan del mismo modo que en muchos otros lenguajes, como 
C++. C. VB v similares. Los métodos suelen usarse para iniciar una acción den¬ 
tro de un control Un ejemplo podría ser el método Start del control Timer, 

Puede agregar un método a un control de una de estas dos formas. Puede usar 
el asistente para métodos de C#. al que se puede acceder mediante el Explorador 
de soluciones mientras se está en la Vista de clases o simplemente agregando 
una función pública al provecto. 

El asistente para métodos de C'#. que se muestra en la figura 29.2. permite 
especificar el nombre del método, el tipo devuelto, el método de acceso y la infor¬ 
mación de parámetro de una forma muy sencilla. 


Asistente para métodos de C# - CountDown 


Asistente para agregar métodos de C# 

F-;tr- agrega un metodc a la dase de •”#. 


Acceso al método; 


Tipo de valor devuelto; 


Nombre de método; 


Modificador; Tipo de parámetro: (¡¿ombre de parámetro: 


Lista de parámetros: 


[i* 3 \m 


r 


Agregar 


J Quitar | 


Modificadores del método: 

r Static r P Virtual P Extern P Override P New 

Comentario (notación // no requerida): 


Fmali2ar Cancelar 


*J 



Ayuda 


Figura 29.2. El asistente para métodos de C# crea la estructura básica del código 

necesario para el método 


El inconveniente del asistente para métodos es que sólo proporciona tipos 
simples de devolución. Por ejemplo, imagine que quiere un método que devuelva 
un valor de tipo Font. El cuadro combinado Tipo de valor devuelto no ofrece 
el tipo Font como opcion. 

Cuando baga pruebas con el asistente aprenderá que puede introducir sus pro¬ 
pios tipos en estos cuadros; sus opciones no se limitan a las que le ofrecen los 
cuadros. L.as opciones que presentan sólo son los tipos más usados para que el 
programador inexperto no se contunda. Después de todo, si el asistente mostrara 
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todas las opciones posibles, tardaríamos mucho tiempo en desplazarnos por toda 
la lista en busca del tipo deseado. 

.NET Framework también aporta a los métodos algunas funcionalidades muy 
necesarias. Ahora los métodos pueden sobrecargarse. Es decir, pueden tener el 
mismo nombre mientras su lista de parámetros sea diferente. 

Campos 

Eos campos son simples variables públicas definidas en un control La aplica¬ 
ción contenedora puede asignar al campo un valor determinado y recuperarlo. 
Como sólo son variables, no pueden tener funciones asociadas a ellos Los cam¬ 
pos no pueden realizar cálculos m llamar a métodos cuando se les asigna un valor 
o se recupera de ellos un valor. 

Hay dos tipos de campos: de instancias y estáticos. Un campo es. por defecto, 
un campo de instancia. Un campo de instancia puede contener sus propios datos 
en cada objeto que lo contenga. Cuando un campo es declarado como estático, 
contiene los mismos datos en todas las instancias del objeto. Un campo estático 
no suele ser aconsejable porque otras instancias del objeto pueden cambiar el 
valor y las instancias restantes no se percatarán de ello. 

Los campos proporcionan elementos de código de bajo nivel pero también 
están limitadas en términos de funcionalidad. Puede asignar y recuperar los valo¬ 
res de un campo, pero al hacerlo no puede desencadenar otras acciones dentro del 
control. Los campos son útiles cuando se necesita asignar parámetros de opera¬ 
ción a un control 

Eventos 


Para definir un evento, antes debe hacer una declaración de clase publica, 
como la siguiente: 

Public event EventHandler Expired; 

Puede usar eventos con controles de Windows de uno de estos dos modos: 
puede hacer clic en el icono Event en la ventana Propiedades y hacer doble 
clic en el evento para agregar el controlador automáticamente o puede crear un 
controlador de eventos usted mismo. 

Un evento básico se declara como un tipo EventHandler. pero tiene mu¬ 
chos mas tipos de evento entre los que elegir y cada uno tiene una firma única. El 
parámetro de cada evento contiene una estructura System. EventArgs. Esta 
estructura permite al control pasar información al evento, con lo que define mu¬ 
chas aspectos, como qué desencadena el evento, qué control hace que se desenca¬ 
dene el evento y aspecto similares. Antes de escoger un tipo de evento para un 
control, asegúrese de que conoce los diferentes tipos, además de los parámetros 
que pasa cada uno. 


645 



Aprender con un ejemplo 

Empecemos creando un control temporizador de cuenta atrás. Este ejercicio le 
permitirá estudiar los entresijos de la creación de controles. 

Cómo crear un temporizador de cuenta atrás 

Antes de empezar a crear el control temporizador de cuenta atrás, debe decidir 
lo que hará y lo que no liará este control Esto simplificará el proceso de crear el 
control. Siempre es bueno tenerlo todo bien planificado antes de empezar un 
provecto de control, incluso más que en cualquier proyecto de programación típi¬ 
co. Este control particular deberá tener las siguientes caracteristicas: 

• El control deberá ser un componente visible que pueda colocarse en un 
formulario. Este control deberá tener las propiedades habituales, como 

BackColor. Anchor, etc. 

• El control deberá recibir un valor que indique el numero de segundos desde 
los que empezar la cuenta atrás. 

• El control deberá tener un método Start ( ) y Stop ( ) para empezar y 
terminar la cuenta atrás. 

• Finalmente. El control deberá desencadenar un evento cuando la cuenta 
atrás llegue a cero. 

Una vez definidos los requisitos, puede empezar a crear su control. 

Abra Visual Studio NET y cree un nuevo proyecto de biblioteca de control de 
Windows. Llame a este proyecto CountDown. como muestra la figura 29.3. 



[Proyecto para crear controles que se van a utilizar en aplicaciones para Windows. 


Nombre: | CountDown 

Ubicación: | C:\source 3 Examinar. .. j 

C Agregar a solución Cerrar solución 


El proyecto se creará en C:\source\CountDown. 
*Más I i 


Ayuda 


Figura 29.3. Cree un nuevo proyecto de biblioteca de control de Windows 
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1 Cuando Visual Studio haya creado la estructura basica de su control, se le 
mostrara un UserControl. Éste será la interfaz visual para su control 
CountDown. Aquí es donde se coloca cualquier elemento visual que quie¬ 
ra que el usuario vea o con el que quiera que interactúe.2. Lo primero que 
debe hacer es colocar un control Label en UserControl. como mues¬ 
tra la figura 29.4. 

3. Cambie la propiedad Anchor de este control Label a Top.Left. 
Bottom.Right . Esto asegura que cuando el control cambie de tamaño, 
la etiqueta también lo haga. Debe tener mucho cuidado cuando agregue 
componentes existentes a un control porque muchos elementos pueden cam¬ 
biar de aspecto cuando el usuario coloca un control en el formulario. 

4. Ahora debe agregar un control Timer al proyecto (desde el cuadro de 
herramientas). El control Timer permite contar un segundo cada vez has¬ 
ta que crea que el tiempo se ha agotado. El aspecto externo del control ya 
está completo. Ahora debe agregar el codigo que apoye a este control. 


CountDown - Microsoft Visual C# JNET [diseñar] - UserControll.es 


Archivo Edición Ver Proyecto Generar Depurar Datos Herramientas Ventana Ayyda 

J - U - -5= a & tfr v _ > Debijq - UÉ» • 3, & ~ ' ” 

Propiedades 


U | IJserf ontroll .ts Pn ipi^daij--- del j 4| 
Acción de genera Cumpil-suon 


Metr-irmeriia peí■■ 

Nnri it'1 e 'Je . jr r- hr-, U-.et ' lonh C 


Acción de generación 

rJ Cómo se relaciona el archivo cotí los 
rJ procesos de generación e impleme 

Explorador de soluciones - Coun.,. 9 

■ : ji n j i 'a 

- .ni'J,|r,r,'..MUnH'..i,1 pf .1 »yectC '! 

.:/] CountDown 
* P-re.en..ev 

A-,-.emt.ly!r.iu 
3 UserControll.es 




i álub l á'lo ? 


UserControll.es [Diseño] 


Lín 17 Col 1 Car 1 


Figura 29.4. Coloque una etiqueta en UserControl 


5. En el listado 29.1 declaró una variable de miembro para que contuv iese el 
numero de segundos desde los que el temporizador de cuenta atrás empeza¬ 
ría a contar. También debe declarar un EventHandler para que se 
dispare cuando el control llegue al final de la cuenta atrás. Coloque el 
siguiente código inmediatamente debajo de la declaración de clase de 
UserControl: 
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Listado 29.1. Miembros públicos 


prívate int m Seconds; 

public event EventHandler Expired; 

6. La variable m Seconds no necesita estar expuesta al contenedor de con¬ 
troles. sino sólo al propio control, por lo vamos a declarar la variable 
como privada. Al declarar un EventHandler publico. Expired apa¬ 
rece en la ventana de eventos. De modo que puede programar este evento 
con sólo hacer doble clic en él. 

7 En el evento Tick del objeto Timer. debe restar un segundo del número 
total de segundos. Luego puede comprobar si el número total de segundos 
ha llegado a cero. En caso afirmativo, debe detener el temporizador y 
desencadenar el evento Expired. Después, puede actualizar el control 
Label para que muestre el valor del control CountDown Timer en ese 
momento En la ventana Propiedades, haga clic en el cuadro combinado 
Selector de objeto y seleccione el control Timer. A continuación haga 
clic en el botón Eventos de la barra de herramientas en la parte superior de 
la ventana Propiedades. Verá todos los eventos que muestra el control 
Timer Llaga doble clic en el evento Tick. Coloque el código del listado 

29.2 en el controlador de eventos Tick del control Timer. 

Listado 29.2. El evento Tick actualiza el control 

prívate voici timer1_Tick(object sender, System.EventArgs e) 

{ 

m_ Seconds -= 1; 

if (m_Seconds <= 0) 

{ 

time r1.S top ( ) ; 

Expired (t h i s ,e) ; 

} 

labell.Text = m_Seconds.ToString(); 

} 

8. Su control también necesita un método public ( ) que permite que el 
contenedor inicie el control para que empiece a contar segundos. El listado 

29.3 define el intervalo del control Timer (en milisegundos) y luego inicia 
el control Timer. Una vez que el temporizador ha sido iniciado, debe 
actualizar el control Label porque no se actualizará hasta un segundo 
después de que el temporizador desencadene el evento Tick por primera 
vez. 

9. Para agregar un método al control, cambie la vista del explorador de solu¬ 
ciones a vista de clase haciendo clic en la ficha Vista de clase. Expanda 
la vista de clase hasta que encuentre las clases de controles. Haga clic con 
el botón derecho del ratón, seleccione Agregar y luego Agregar méto- 


648 



dos. El Asistente para métodos de C# se abrirá, como muestra la 
figura 29.5. 


Asistente para ayreijar métodos de I # 

f-.| r - .r.i-vf •jriív i'jr «J-i un jü#u.Ju 3 l-s c.-ar-e Jr <_#. 

Acceso al método: Tipo de valor devuelto: Nombre de método: 

íi'"^i" Z! (SE £| ("-^t 

Modificador: Tipo de parámetro: Nombre de parámetro: Lista de parámetros: 

m i] r-r- 

Agregar j Quitar | I 

Modificadores del método: 

f~ Static 1“ r Virtual f~ Extern P Override P New 

Comentario (notación // no requerida): 


l~- 

Finalizar [ Cancelar | Ayuda j 

Figura 29.5. Asistente para métodos de C# 



10. Llame a este método Start y asegúrese de que es un método publico. 
Puede dejar todos los otros valores que se ofrecen por defecto, fias crear 
el nuevo método, agregue el código del listado 29.3 al listado del codigo 
del método. 


Listado 29.3. Método Start 


public void Start () 

{ 

't ime r 1 . Inter va 1 - 10 00 ; 

timerl.Start O I 

1 abe 1 i . Text-m_Seconds .ToStnng () ; 

} 

1 1. Un método Stop () complementa al método Start {) . El método Stop () 
debe detener en primer lugar al control Timer para que el evento Ti ck 
no vuelva a desencadenarse. También debe asignar el valor de la propiedad 
Seconds a la variable de miembro m Seconds. Esto garantiza que si el 
control se inicia de nuevo, lo hara desde el principio y no desde donde se 
encontraba cuando fue detenido. Cree un nuevo método llamado Stop ( ). 
del mismo modo que creo el método Start ( ) . Agregue el codigo del 
listado 29.4 a este nuevo método. 

Listado 29.4. Método Stop 


public void Stop() 
{ 
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tíme r1.Stop ( ) ; 
m Seconcis = this . Seconds ; 

} 

Aun no ha creado la propiedad Seconds. La propiedad Seconds permite 
conseguir v establecer el número total de segundos desde los que el control empe¬ 
zara la cuenta atrás. Una propiedad se crea de una manera muy parecida a un 
método. 

1, Desde la vista de clase del Explorador de soluciones, haga clic con el boton 
derecho y escoja Agregar y luego Agregar propiedad. El asistente para 
propiedades de C#. mostrado en la figura 29.6. se abrirá. 


[Asistente para propiedades de C# - CountPown 


Asistente para agregar propiedades de C# 

Lste asisten** agrega una propiedad a la clase de C#. 

Acceso a la propiedad: Tipo de propiedad: 

|pubk 3 fffl 

Descriptores de acceso: 

C 9 et C set <* get/set 

Modificadores de la propiedad: 

(* Ninguno C Static C Virtual C 


m -_ üi 



Nombre de propiedad: 

▼ [ Jseconds 


Comentario (notación II no requerida.); 

I 


Finalizar Cancelar 


Figura 29.6. En el asistente para propiedades de C#, llame a esta propiedad 
Seconds. Asegúrese de que esta propiedad tenga acceso público y de que el tipo de 

la propiedad sea Int 


2. Queremos que la aplicación contenedora de los controles pueda asignar un 
valor a esta propiedad o leer un valor de ella. Por tanto, queremos que el 
descriptor de acceso sea get/set. Agregue el código del listado 29.5 al 
codigo creado por el asistente para propiedades de C#. 

Listado 29.5. Propiedad Seconds 


public int Seconds 
{ 

get 


return m Seconds; 


set 

{ 
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m Seconds 


valué; 



Preste especial atención a la palabra clave valué. Cuando se pasa un valor a 
una propiedad (por ejemplo, set), puede ser recuperado mediante la palabra 
clave valué. 

Hasta ahora, su control no es muy sofisticado, ni presenta buen aspecto, pero 
funciona. En este momento, puede crear el nuevo control seleccionando Generar 
solución en el menú Generar. 

Ahora genere una prueba de carga que use este control y permita comprobar 
todos los métodos, propiedades y exentos del control. 

Cómo crear una prueba de carga CountDown 

Uno de los puntos fuertes de Visual Studio es que permite agregar un proy ecto 
a un proyecto existente, lo que es muy importante para probar controles. Esta 
posibilidad permite crear una aplicación de prueba de carga que usa uno de los 
controles que acaba de crear. Cuando encuentra algún error, no solo se interrum¬ 
pe la aplicación, sino que se interrumpe en el punto del codigo donde el control 
funcionó mal. Esto le ahorrará tener que pasarse incontables horas depurando 
codigo cuando empiece a crear controles complejos. Siga los siguientes pasos 
para crear una prueba de carga: 

1 . Desde el proyecto de control CountDown. haga clic en el menú Archivo 
y seleccione Nuevo>Proyecto. Se abrirá la ventana Nuevo proyecto 

2. Seleccione Aplicación para Windows y llame a esta aplicación 
CDHarness. En la parte inferior de esta ventana, asegúrese de que el 
botón de opción Agregar a solución este seleccionado. Haga elíc en Acep¬ 
tar 

3. El Explorador de soluciones muestra los dos proy ectos. Haga clic con 
el boton derecho del ratón en la aplicación CDHarness en el Explorador 
de soluciones y seleccione Establecer como proyecto de inicio. A par¬ 
tir de ahora, cuando ejecute la aplicación, la prueba de carga sera la apli¬ 
cación principal que ejecuta y puede usar cualquier otro proy ecto que este 
abierto en ese momento en el "grupo". 

4. Asegúrese de que esta en el proyecto CDHarness haciendo clic en el 
Explorador de soluciones. Haga clic con el boton derecho del ratón en 
el cuadro de herramientas y escoja Personalizar cuadro de herramien¬ 
tas. 

5. Cuando se abra la ventana Personalizar cuadro de herramientas, haga 
elic en la ficha Componentes de .NET Framework Ahí es donde se 
agrega el nuevo control al proy ecto. 
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6. Haga clic en el botón Examinar y busque el control temporizador 
CountDown. Cuando lo encuentre, selecciónelo y márquclo. Haga clic en 

Aceptar 

7. En la lista de controles, verá este control; marque el cuadro junto a él. 
Ahora puede hacer clic en Aceptar en este formulario. En el Cuadro de 
herramientas, verá el control temporizador CountDown en la lista. 

8 Haga doble clic en el control para agregarlo a su proyecto. Mientras esta 
en el cuadro de herramientas, agregue también dos botones a su formula¬ 
rio. El primer botón se usa para iniciar el temporizador de cuenta atrás y el 
segundo boton se usa para detener el control Countdown. Alinee y esta¬ 
blezca las propiedades de texto como se muestra en la figura 29.7. 


U Countdown H0E3 


Start |Stop | 


Figura 29.7. La interfaz principal de su aplicación de carga CountDown 

9. Haga doble clic en el boton Start de su aplicación para que pueda empezar 
a codificar. Agregue el código del listado 29.6 al evento Click del botón 

Start 

Listado 29.6. Inicia el control 

prívate voicl but t on l_Cl íck ( ob j ect sender, System. EventArgs e) 

{ 

c clT i me r 1 . S e cond s = c 0 ; 
cclTimer i . Start ( } ; 


10. El boton Start sirve sólo para una cosa: para preparar e iniciar el control 
CountDown. Para empezar, establezca en 60 el numero de segundos y 
luego llame al método Start del control. 

1 1 También necesita un modo de detener el control Haga doble clic en el 
boton Stop para insertar código en el evento Click de este botón. Inserte 
el siguiente codigo del listado 29.7 en el evento Click del botón Stop. 

Listado 29.7. Detiene el control 

prívate void button2_Click(object sender, System.EventArgs e) 

{ 

cdTimer1.Stop(); 

} 
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12. El evento Expired del control CountDown debe realizar alguna acción 
que le informe de que la cuenta atrás ha llegado a cero. En la ventana 
Propiedades, haga clic en el botón Eventos en la barra de herramientas. 
A continuación, haga doble clic en el evento Expired. Es en este código 
en el que debe codificar esa acción especial. No intente nada extravagante; 
simplemente vamos a cambiar el título de su formulario a Done. Inserte el 
código del listado 29.8 en el evento Expired del control CountDown. 

Listado 29.8. Código del evento Expired 

prívate void cdTimerl_Expired(object sender, System.EventArgs e) 

{ 

t his.Text = "Done!"; 

} 

Su control v su aplicación de prueba ya están listos para ser ejecutados. Pulse 
F5 para ejecutar la aplicación. Cuando se abra la aplicación, haga clic en el boton 
Start para iniciar la cuenta atrás. Su aplicación de prueba deberá empezar a 
contar hacia atrás. Cuando la cuenta atrás llegue a cero, el título del formulario 
deberá cambiar, gracias al evento Expired. 


Cómo usar una biblioteca de clases 


Una biblioteca de clases es un modo eficiente de reutilizar y distribuir el códi¬ 
go reutilizable. Las bibliotecas de clases se almacenan en las DLL. pero no es 
necesario envolver el codigo con instrucciones y declaraciones como en otros 
lenguajes, como C++. 

Como con cualquier componente reutilizable. las bibliotecas de clase propor¬ 
cionan constructores y destructores de clase para la imcialización y la limpieza, 
pero estos elementos no son realmente imprescindibles. 

Para empezar su viaje por las bibliotecas de clase, cree una sencillo DLL con 
algunos métodos públicos de prueba. A continuación, cree el control con algunos 
atributos adicionales. 

Cómo crear una clase para calcular el efecto 
de viento 

La biblioteca de clases de cálculo del efecto de viento no sólo proporciona una 
función para calcular la temperatura del aire, si que también proporciona funcio¬ 
nes para diferenciar los grados Celsius de los grados Fahrenheit y viceversa. 

Como las operaciones que va a realizar en esta biblioteca de clases pertenecen 
a dos categorías distintas, conversión y cálculo, debe incluir dos clases separa¬ 
das. Cree un nuevo provecto de biblioteca de clases y llámelo 1 emperature Vi- 
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sual Studio creará el codigo que será la estructura básica mostrado en el listado 

29.9. 


Listado 29.9. Código creado para una biblioteca de clases por Visual Studio 

using System; 
namespace Temperature 

í 

/// <summary> 

/// Descripción breve de Classl. 

/// </sumiría ry> 

public class Classl 
{ 

public Cías s1 () 

{ 

// 

// TODO: Agregar aquí la lógica del constructor 
// 

} 

} 

} 


Visual Studio ha creado un espacio de nombres, una clase y un constructor de 
clase. La clase y el constructor de clase son públicos. Esto no es una coincidencia. 
Cualquier aplicación que use esta biblioteca necesita acceder tanto a la clase 
como a los miembros específicos dentro de la clase. 

1. Para empezar nuestro ejemplo, elimine la clase y el constructor de clase y 
reemplácelos por el codigo del listado 29.10. 

Listado 29.10. La dase y el constructor Cale 


p u b1ic cíass C a1c 
í 

public Cale O 
{ 

| 

) 

2. La clase Cale es donde colocara el método de cálculo del efecto de viento. 
De esta forma, estamos seguros de que nuestro calculo del efecto de viento 
queda separado de los métodos de conversión que pronto agregara. Inserte 
el código del listado 29.1 1 en la clase Cale. 

Listado 29.11. Cálculo del efecto de viento actual 

public double WindChi11(double DegreesF, double WindSpeedMPH) 

{ 

double WmdRaised; 

WindRaised - System..Math.Pow(WindSpeedMPH, . le I ; 
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(35.75 * WindRaised) + 


return 35.74 + (.6215 * DegreesF) - 

(.4275 * DegreesF * WindRaised); 

} 

} 

3. También agregaremos algunos métodos que no son cálculos, sino conver¬ 
siones. Por tanto, deberá añadir una nueva clase. Esta nueva clase se lla¬ 
mará Conversión, como se puede ver en el listado 29.12. Agregue la 
nueva clase y constructor de clase al proyecto. 

Listado 29.12. Agregar una segunda clase a la biblioteca de clases 

public class Conversión 
{ 

public Conversión() 

| 


} 

4. Inicie la nueva clase con una función que calcule la temperatura en grados 
Falnenheit a partir de la temperatura en grados Celsius. Es poco probable 
que el valor devuelto o el parámetro sean valores enteros, de modo que es 
importante que ambos sean valores double. El listado 29.13 contiene el 
listado completo de la función. Agregue este codigo a la clase 
Conversión. 

Listado 29.13. Conversión de Celsius a Fahrenheit 

public double Ce1cToFahr(double Celsius) 

t 

return (9/5) * (Celsius + 32); 

} 

5. Como ha incluido una función de conversión de Celsius a Fahrenheit. es 
lógico incluir la conversión inversa. Agregue el método del listado 29.14 a 
la clase Conversión. 

Listado 29.14. Conversión de Fahrenheit a Celsius 

public double FahrToCelc(double Fahrenheit) 

{ 

return (5/9) * (Fahrenheit - 32); 

} 

Con esto finaliza la funcionalidad que queremos incluir en el objeto biblioteca 
de clases, de modo que ya puede crear la DLL seleccionando Generar solución 
en el menú Generar. Una vez que todo está en su sitio, observe como se utilizan 
los métodos públicos que hay en su interior. 

1. Cree un nuevo proyecto de aplicación de consola y llámelo DLLTest. En 
el menú Proyecto, seleccione Agregar referencia y a continuación haga 
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clic en el boton Examinar Busque la DLL que acaba de crear y haga 
doble clic sobre ella!. Ya puede hacer clic en Aceptar para salir de la 
ventana Agregar referencia 

2. Tras agregar una referencia, puede simplemente erear una nueva v ariable 
del tipo adecuado y hacer referencia al método que prefiera. El listado 
29. 1 5 contiene el listado completo del codigo de la aplicación DLLTest 

Listado 29.15. Código fuente de la aplicación DLLTest 

u s i n g !'S y s t e rn ; 

11 a m e s p a c e I' LLTp s 1“ 
í 

/// *■" summa ry> 

/// Descripción breve de C]a s s1 . 

/// </summa ry> 

cías s C1 a s s i 
1 

static void Ma in ( string[] a rgs) 

{ 

Temperat.ure . Cale WCMethod - new Temperatura .Cale ( ) ; 
Temperature.Conversión ConvMethod = new 
Temperature.Conversión ( ) ; 

Consolé .WnteLme f "Wmd chi.1.1 at 5Ü degrees with 3 5 MPH 
: { f)} De g r e e s " , WCMe t h od . Wi. ndCh i 11 ( 5 0,3 5) ) ; 

Consolé .WnteLme ("32 Degrees Fahrenheit t.o Celsius : 

{ü } Degrees",ConvMethod.FahrToCelc(32) ) ; 

Consolé .WnteLme f"0 Degrees Celsius to Fahrenheit : 
i 0 } Degrees",ConvM ethod.CelcToFahr(0 ) ) ; 

} 

} 

} 

El acceso a los métodos es una tarca muy sencilla: cree nuevas variables del 
tipo Tempera ture . Conver s i on y Tempera ture . Ca 1 c y luego acceda 
a sus métodos públicos. Esta aplicación de ejemplo calcula el efecto del v iento 
con una temperatura de 50 grados y una velocidad del viento de 35 millas por 
hora: a continuación calcula la temperatura en grados Celsius y Fahrenheit El 
resultado de esta aplicación se muestra en la figura 29.8. 


Resumen 


NET presenta algunas innovaciones en la forma de construir controles extre¬ 
madamente importantes. A medida que cree controles para sus propios proy ectos 
o para implementar en la Web. irá descubriendo algunos av ances en la programa¬ 
ción. como el objeto State, que le ahorrarán grandes cantidades de tiempo. 
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Figura 29.8. DLLTest le enseña a usar un control de biblioteca de clases 









30 


Cómo 

construir 

aplicaciones 

móviles 


Las aplicaciones Web móviles son un grupo de tecnologías emergentes que 
permiten que el contenido Web sea accesible a un número mavoi de público que 
el que puede ofrecer Internet actualmente. Puede crear aplicaciones de Intranet 
corporativa para los empleados que se mueven entre los edificios de la compañía 
o para los que se desplazan entre continentes durante sus viajes de negocios. Este 
capítulo describe varios apartados de las aplicaciones Web móviles. 

La red inalámbrica 

El concepto de acceso a Internet mediante dispositivos móviles Hc\a mucho 
tiempo entre nosotros pero ha tardado en ser aceptado. Las herí amientas adecua¬ 
das para crear contenido Web han sido bastante escasas. . NE Y Fiamework. junto 
con el Mobile Internet Toolkit de Microsoft, permite crear emocionantes aplica¬ 
ciones Web que se pueden usar en distintos tipos de dispositiv os mo\ des. 

Estos dispositivos móviles inclinen dispositivos Windows C E. dispositivos 
Pocket PC y muchos teléfonos móv iles. Evidentemente, la mayoría de los disposi¬ 
tivos móviles están muy limitados en comparación con los navegadores Web a los 
que estamos acostumbrados. No es sólo que los dispositivos móviles dispongan 
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de menos espacio para el contenido, muchos de estos dispositivos carecen de 
color o. en alguna otra forma, de la capacidad para mostrar gráficos. 

Este capítulo empieza estudiando el software que necesita, junto con los 
emuladores adecuados que puede usar para probar su código, en caso de que no 
tenga acceso a un dispositivo móvil con acceso a Internet. 

Introducción al Mobile Internet Toolkit 

El Mobile Internet Toolkit de Microsoft permite a Visual Studio crear aplica¬ 
ciones Web seleccionándolo como proyecto en el menú Nuevo proyecto. Este 
conjunto de herramientas no se incluye en el mismo paquete que Visual Studio 
NET. por lo que debe ser descargado de forma separada desde la pagina Web de 
Microsoft El Mobile Internet Toolkit actualmente se encuentra en la versión 1 0 
y se puede descargar desde http://msdn.microsoft.com/download. 
Cuando llegue a esta pagina, debe seleccionar Software Development Kits en el 
marco a la izquierda de su navegador Web y luego seleccionar Microsoft Mobile 
Internet Toolkit 

El Software Development Kit (SDK) actual ocupa algo más de 4MB y contie¬ 
ne varios controles ASP.NET para generar Lenguaje de marcado inalámbrico 
(WML) y varios detalles de HTML, además del módulo que se añade a Visual 
Studio NET. documentación y ejemplos de aplicaciones. Asegúrese de que al 
instalar el SDK. todos los procesos de Visual Studio están cerrados. 

Emuladores 

Los emuladores permiten escribir aplicaciones para dispositivos y probarlas 
sin tener que comprar realmente uno de los dispositivos. Hay emuladores para 
teléfonos móviles. PDA. equipos de escritorio y dispositivos intermedios. Los 
siguientes apartados tratan sobre algunos de los emuladores más populares, que 
puede descargar y empezar a escribir aplicaciones para ellos. 

Nokia 

En la página Web de Nokia (http://www.nokia.com). puede descar¬ 
garse un emulador de teléfono Nokia para probar sus aplicaciones Web para 
teléfonos móviles. Esta descarga es de casi 22MB y requiere el entorno de ejecu¬ 
ción Java, lo que añade otros 5MB a su descarga. El emulador Nokia actualmente 
le permite elegir entre uno de los tres diferentes modelos Nokia que ofrece para 
que realice sus pruebas. Esta aplicación es un valioso recurso para probar sus 
aplicaciones. 

Pocket PC 

El emulador de Pocket PC se incluye en el Microsoft Embedded Devices Toolkit 
Es un excelente emulador por si no posee un Pocket PC ya que Pocket Internet 
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Explorer admite muchas más funcionalidades que la mayoría de los dispositivos 
móviles del mercado actual. Tenga en cuenta que el tamaño real de este conjunto 
de herramientas es superior a los 300MB. Si no posee una conexión a Internet de 
alta velocidad, es mejor que use Microsoft Mobile Explorer, del que le hablamos 
en la siguiente sección. 

Microsoft Mobile Explorer 

Microsoft Mobile Explorer es una descarga de solo 3MB y se usa principal¬ 
mente para integrarse con Visual Studio. Cuando pruebe sus aplicaciones, esta¬ 
blezca MME como su navegador por defecto. 

Cómo crear un calculador de edades 


Tras instalar el Mobile Internet Toolkit de Microsoft, cree un nuevo proyecto 
de C#. Apreciara una nueva opción llamada Mobile Web Application, como mues¬ 
tra la figura 30.1. 


Nuevo proyecto 


Tipos de proyecto: 




Plantillas; 


+ _| Proyectos de Visual Basic 

Proyectos de Visual C# 

_| Proyectos de Visual Ü+ + 

_| Proyectos de instalación e implementacion 

+ _| Otros proyectos 

Mobile Web 
Application 

1* 

Apiic ación 
Web ASP.NET 

——3 

Servicio ‘Web 
ASP.NET 

_| Soluciones de Visual Studio 

*i¿] 

■W 

-ir 

xfljll 


Biblioteca de 
controles Web 

Aplicación de 
consola 

Windows _▼] 


A project Por creating an application viewable on PDAs, cellphones, and other mobile devices 
Nombre; | 

Ubicación: | 

El proyecto se creará en http://powerhouse/YourAge, 

TMas | 




Aceptar 


Ayuda 


Figura 30.1. La nueva opción Mobile Web Application se agregó cuando instaló 

Mobile Internet Toolkit. 


Esta aplicación de ejemplo toma su año de nacimiento para calcular cual es su 
edad actual (o la que debería ser). 

1. Llame al provecto YourAge y cuando Visual Studio cree la estructura de 
su aplicación, vera un formulario Web Mobile en blanco llamado Forml. 

2. Haga clic con el botón derecho del ratón en este formulario y seleccione 
Copiar. Ahora haga clic con el botón derecho del ratón debajo del formu¬ 
lario v seleccione Pegar. Esta aplicación necesita dos formularios: 
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uno que adquiere la información del usuario y otro que muestra los resul¬ 
tados. 

3. Una vez que tenga los dos formularios, coloque un control Button. un 
Label y un TeztBox en Forml y coloque un control Label v un 
Link Label en Form2. Coloque estos controles como se muestra en la 
figura 30.2. 

Una vez situados los controles, debe asignar todas las propiedades adecuadas. 
La tabla 30.1 contiene las propiedades de cada control. Colóquclas adecuadamen¬ 
te antes de seguir adelante. 


't.jft fOg? MobileWebForml. aspx* | MobM'-'ebF orrr.l a;.p- c: 

Formi 

I 1 ate of'Birth 

| Show Age | 

Form2 

[lbl'I’urrentAge] 

Tty Aj-yjiti 1 


Figura 30.2. Estos formularios son necesarios para la aplicación YourAge. 


Tabla 30.1. Propiedades del control YourAge 


Formulario 

Control 

Propiedad Ñame 

Propiedad Text 

Forml 

Label 

Labell 

Year of Birth 

Forml 

Text Box 

txtDOB 

<Empty> 

Forml 

Button 

Commandl 

Show Age 

Form2 

Label 

IbICurrentAge 

<Empty> 

Form2 

Link Label 

Linkl 

Try Again 

i 


Debe establecer una propiedad antes de empezar a codificar. Seleccione el 
control Link Label y asigne la propiedad NavigateUrl a Forml. Esto 
asegura que. cuando se hace elíe en el vinculo, el usuario es en\ lado de vuelta al 
Forml del proyecto. 

Antes de empezar con el código necesario para su programa, examine el códi¬ 
go oculto de estos formularios Web Mobilc. En la parte inferior del diseñador de 
formularios hay dos botones con la etiqueta Diseño y HTML Haga clic en el 
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botón HTML para mostrar el codigo HTML oculto de estos formularios, que 
debe ser igual que el codigo del listado 30.1 

Listado 30.1. Código HTML oculto de los formularios Web YourAge 


< @ Register TagPrefix="mobile" 

Namespace = "Syst. em. Web . UT . Mobi leCont r o 1 s " 

Assembly="System.Web .Mobile, Version='l - 0 . 3 3 0 0 . 0, 

Cul t ur e-neut. r a 1, Publ i cKeyToken—bO 3 t b i / f Ild50a3a" 

< @ Page language-"c#" Codebehmd-"Mob i leWebForm 1 . aspx . es " 

I nher i t s •- " You r Age .Mobil eWebF orml" AutoEventV /1 reup-" f alse" 

< me t a name ="GENERATOR" content = "Microsoft Visual Studio 7.0" > 
<meta name-"GÓDE LANGUAGE" con t. ent - " C# " > 

•■meta name-"vs_targetSchema" cont en t = " h 1t p : / / 
s chema s .microsof t. . c om/Mob i 1 e / P a ge " > 

< body Kral ns : mob i 1 e = " ht t p : / /s chema s . mi c rosoft * r:om/Mob i 1 e / 

WebForm" > 

<mobi1e:Fo rm id="Forml" runat="server"> 

<mobi1e:Labe 1 id-"Labe11" runat="server"> fea r o í Birthm / 
moblie:Labei> 

■■ mob i 1. e : TextBox id="txtDOB" runat = "server" '«• / 
mohile : Text.Bo> 

< mobi1e:Comman d i d = " C ommandi" r u nat-"se r v e r">Sh o w A ge* / 
moblie:C omma nd > 

• /mobi1e:Fomi¬ 
mo bi le: Forrn id-"Form2" runa t = " s e r ve r " > 

•:mob• ; e :Labe 1 id-"1b1Cu r rentAge" runat-"s e rvei " -■ / 
mobi J e:Labe 1 • 

•■'.mob i le : Lmk id="Lmkl" runat = " se rve r " 

Navi gateUrT="#Forml">Try Again!</mobi1e:Link • 

<. / mobi le : Forrn> 

-■ /body:> 

Este codigo es el estándar de HTML combinado con algunos elementos que 
están definidos por el espacio de nombres Mobi leCont rol s Lsta unión de la 
página HTML \ la clase .NET MobileControls puede apreciarse en la linea 
que sigue a Namespace. Cuando empiece a codificar, observe que vanos espa¬ 
cios de nombres ya han sido agregados al provecto por este motivo. 

Ahora esta listo para empezar a codificar su aplicación Web móvil. Este pro¬ 
vecto necesita que haya codigo en un lugar. Haga doble clic en el boton que 
anteriormente colocamos en Forml. El listado 30.2 contiene el codigo que debe 
insertar tras el evento clic de este botón. 

Listado 30.2. Cómo calcular la edad en el evento Click 

prívate void Command1_C1ick(object sender, System.EventArgs e) 

{ 

mt iDOB - System.Convert.Tolntló(txtDOB.Text) ; 
int YearsOld; 

íf (iDOB > 1000) 
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i DOE ; 


Ye a i-; Oíd - 

.* 1 y 

Y-a r O i d - 1YJ - IpOB + B; 

M; ¡ 1 Y: : r'ti: A:j" .'IVr - Y e a i s O1 d . T o S t.nnq ( ) + " y e a r s 



Fn esta parte de! eódigo. deberá realizar algunas tareas. En primer lugar, debe 
convertir en un \ alor entero el año que se introduce mediante la clase Conve r t.. 
A continuación, dependiendo del tamaño de ese año (dos o cuatro dígitos), calcule 
la edad en consecuencia, usando como año actual 2002. 

l ina vez que se ha calculado la edad, asigne la edad y una cadena a su etiqueta 
■ a.; r r • ■ r. i oco.. Su aplicación ya es funcional, pero aunque ha asignado el 
resultado a la etiqueta adecuada, todavía no se muestra la pantalla que contiene la 
información Fn la ultima línea del listado 30.2. asigne ActiveForm a Fornf:. 
Esto carga Form2 en el navegador del usuario para mostrar los resultados. 

Puede ejecutar esta aplicación pulsando F5 y si todo el código se ha realizado 
correctamente, se abrirá el navegador Web que tenga por defecto. Para ver esta 
aplicación en un dispositivo móvil, ejecute su emulador preferido e introduzca la 
URF adecuada Fa figura 30.3 muestra la aplicación ejecutándose en un emulador 
de Pocket PC 


15] Internet Explorer 

9:4Ip i 

| http: //power house/Y our Age 

/(vtgt - Go| 


veat oí Birth: 


Show Age 


View Tools *+ 0 í3 S 0|* 

Figura 30.3. Ejecución de YourAge en un emulador de Pocket PC 


Eras introducir su año de nacimiento, haga clic en el botón Show Age v se le 
mostrará el Form2. como muestra la figura 30.4. 

Felicidades por su primera aplicación Web móvil. Aquellos que usaron Internet 
Explorer o el emulador de Pocket PC para hacer su prueba, se estarán preguntan¬ 
do como se mostrará la aplicación Web en un telefono móvil. Fa figura 30.5 
muestra la misma aplicación ejecutándose en el emulador de telefono móvil Nokia 


664 







Figura 30.5. Nokia 7110 ejecutando la aplicación YourAge 

Cómo puede ver. la pagina presenta un aspecto muy parecido al que mostraba 
en los anteriores emuladores, excepto en algunos detalles de desplazamiento entre 
opciones. Como los Pocket PC son dispositivos en los que se señala y se hace clic, 
el desplazamiento se realiza mucho mas suavemente. El telefono móvil, por otra 
parte, realiza todos sus desplazamientos entre opciones usando sus. aproximada¬ 
mente. 20 botones. Es decir, no puede simplemente hacer clic en un botón o un 
vínculo para avanzar; debe usar los botones para desplazarse hacia arriba o abajo 
y seleccionar los v ínculos antes de poder seguirlos. 













Funciones de los dispositivos móviles 


La clase System. Web .Mobile . MobileCapabi li t ies contiene xa¬ 
nas docenas de propiedades que se usan para detectar las funciones de un dispo¬ 
sitivo móvil. Por ejemplo, puede consultar la resolución de pantalla de un 
dispositivo, comprobar si es de color o de blanco y negro y consultar si el dispo¬ 
sitivo es capaz de mandar correo, por nombrar solo algunas. 

Al crear aplicaciones Web móviles, es importante tener en cuenta los distintos 
tipos de dispositivo que pueden acceder a la aplicación. A diferencia de los 
nav egadores conv encionales, cuya funcionalidad varia muy ligeramente, puede 
haber enormes diferencias entre ver una página en un telefono móvil o. por ejem¬ 
plo. en un PDA que utiliza Windows CE. Debe asegurarse de que sus paginas 
serán procesadas adecuadamente por cada dispositivo. 

Empiece usando la clase De vi ce para comprobar el numero de caracteres 
máximos, horizontal y verticalmente, que admite la pantalla de su dispositivo 
móvil. Abra la aplicación YourAge que creó en el listado 30.2 y agregue dos 
controles Labe ! a Form2. Cambie las propiedades Ñame de estas etiquetas a 
] b i He icjht y iblWidth. 

Ahora debe modificar el código fuente original para llenar estas etiquetas des¬ 
pués de que se muestre Form2. El listado 30.3 contiene el código que debe añadir 
(en negrita) para que la nueva funcionalidad surta efecto. 

Listado 30.3. Cómo mostrar las funciones de un dispositivo 

prívate void Commandl_Click(object sender, System.EventArgs ei 

{ 

int i DDE = System.Convert.Tolnt16(txtDOB.Text) ; 

int YearsOid; 

íf (iDOB > 1000) 

YearsOid = 2002 - iDOB; 

e 1 s e 

Y earsOid = 100 - iDOB + 2; 

lblCurrentAge.Text = YearsOld.ToString( ) + " years oíd." ; 

Ib 1Height.Text - "Height: " + 

Devise.Se reenCharactersHeight; 

IblWidth.Text = "Width: " + Device.ScreenCharactersWidth; 

ActiveForm = For m2; 

} 


En un Pocket PC. puede conseguir 17 x 34 caracteres, mientras que en un 
telefono móvil Nokia 7110 sólo puede conseguir 4 x 22. como muestra la figura 
30 . 6 . 

No todas las propiedades de esta clase funcionan en todos los dispositiv os. El 
archivo de avuda de Mobile Internet Toolkit de Microsoft contiene una tabla de 
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funciones de los dispositivos que define qué propiedades funcionarán normalmen¬ 
te con HTML, cHTML y con WML. 



El cuadro de herramientas de Visual Studio NET también tiene un control 
llamado DeviceSpeci f ic que puede ser situado en un formulario para que 
realice ciertas tareas (dependiendo del dispositivo con el que se este comunican¬ 
do). Esto se consigue mediante filtros y reduce considerablemente el esfuerzo que 
sería necesario para codificar todos los distintos contextos posibles. 


Funcionamiento de los controles móviles 


Los controles Web móviles deben ser muy versátiles a la hora de mostrar 
interfaces visuales. Algunos controles necesitan más espacio del disponible en la 
mayoría de los dispositivos móviles. Cuando esto sucede, el control debe determi¬ 
nar cómo manejar la situación. Las siguientes secciones estudian dos de estos 
controles. Calendar e Image. y cómo modifican sus interfaces visuales cuan¬ 
do es necesario. 

Cómo usar el control Calendar 

El control Calendar permite mostrar un completo calendario en su pagina 
Web móvil. Para comprobar lo versátil que es este control, cree una nueva aplica- 
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cion Web móvil v coloque un control Calendar en el Forml del proyecto. 
Cuando ejecute esta nueva aplicación mediante su navegador por defecto o me¬ 
diante el emulador de Pocket PC. verá un calendario mensual completo que per¬ 
mite hacer elie en cualquier día de la semana. En la figura 30.7 se muestra esta 
aplicación ejecutándose en un Pocket PC. 




¡ ht tp: / /power house / SLhtídul i 
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Figura 30.7. Aplicación de prueba de Calendar ejecutándose en un emulador de 

Pocket PC 

¿Cómo puede mostrarse este calendario en un dispositivo mucho mas pequeño, 
como por ejemplo un telefono móvil? El control Calendar sabe en que tipo de 
dispositiv o v a a ser mostrado y cambia su interfaz de usuario en consecuencia. La 
figura 30.X muestra esta misma aplicación Web ejecutándose en un emulador de 
teléfono móvil. Ya no v e el calendario, sino que ve la fecha actual seguida de dos 
opciones. Estas opciones le permiten introducir directamente una fecha o buscar¬ 
la semana a semana y luego por cada dia de la semana. 

Este tipo de comportamiento no exige ningún tipo de programación, lo que 
libera al programador de mucho trabajo. 

Cómo usar el control Image 

El control Image es otro control único muy parecido al control Calendar . 
Le permite mostrar una imagen en varios tipos de dispositivos móv lies con poca o 
ninguna programación Cree una nueva aplicación Web móvil de C# y coloque un 
control Image en Form 1. Proporcione a la ImageU r l de este control Image la 
ruta de la imagen que desea mostrar. Esta imagen puede ser un mapa de bits 
(brnp). una imagen JPEG (jpg) o alguno de los otros tipos que acepta. Para el 
ejemplo, escoja una imagen en color jpg . 

Al ejecutar esta imagen en un Pocket PC se muestra la imagen correctamente, 
como muestra la figura 30». 
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Figura 30.8. Aplicación de prueba de Calendar ejecutándose en un emulador 

de Nokia 
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Figura 30.9. Pocket PC muestra la imagen sin problemas aparentes 

Si intenta ver esta misma página con el emulador de teléfono móvil Nokia, 
recibirá un mensaje de error indicando que no se pudo cargar la página. Esto 
obviamente es debido a que la página no es de un tipo que se pueda ver en una 
pantalla en blanco y negro de un tamaño tan pequeño. 

Sin embargo, se puede solventar este problema. Puede convertir su imagen 
JPG en una imagen de mapa de bits de dos colores (blanco y negro), también 
conocido como de rnupu de bits i nctld lubrico (WBMP). que el dispositivo moví! 
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puede procesar. En el evento Page Load del Forml. puede comprobar la 
propiedad Device . Pref erredRenderingType para ver que imagen debe 
ser cargada. Si esta propiedad devuelve wmlll. debe ajustar la propiedad 
ImageUr 1 del control Image a WBMP picture; en caso contrario, puede 
mostrar el original. 

Paginación en dispositivos móviles 

La paginación es la capacidad de un dispositivo móvil de dividir grandes 
cantidades de contenido en varias páginas de información. Esto sucede, por ejem¬ 
plo. cuando se muestra una larga lista de contactos en un formulario Web móvil y 
el dispositivo concreto no puede mostrarlo entero en su pequeña pantalla. 

Le alegrará saber que puede programar este tipo de comportamiento para que 
su formulario Web móvil lo controle automáticamente con sólo cambiar dos pro¬ 
piedades. La propiedad Pagínate, cuando es True. divide automáticamente 
todo el contenido en v arias páginas de información, dependiendo de las posibili¬ 
dades de su dispositivo remoto. También debe asignar la propiedad 
Items Per Page a un control determinado (por ejemplo, el control List) para 
forzar la paginación de un determinado número de elementos. Sin embargo, por lo 
general esto no es necesario ya que el numero por defecto, siete, suele ser dar buen 
resultado. 

Puede comprobarlo creando una nueva aplicación Web móvil llamada 
Contacts. Asigne a la propiedad Pagínate de Forml el valor True v 
agregue un control List a la página. Dele a la propiedad JtemsPerPage del 
control L.i st el valor 7. 

Ahora debe agregar algunos elementos a este control List, como muestra el 
siguiente codigo: 

L i st 1 . Items . Acld ( 11 Kim Pack" ) ; 

Li st Items .Add ( "Timothy Hyde") ; 

I, i st 1 . Items . Add ( "Donna Malone" ) ; 

Til st 1 .Items .Add ("Joshua Trueblood") ; 

List i .Items .Add ("Staci Spnnger") ; 

List 1 .Items.Add("Chris Stephens") ; 

Listl.Items.Add("Amy Sherman"); 

Líst1.Items.Add("Steve Million"); 

Til st 1 . Items .Add ( " Jim Mattingly" ) ; 

List I.Items.Add("Ryan Boyles") ; 

Listl.Items.Add("Scott Leathers"); 

Estos 1 1 elementos se agregan a su lista. Por tanto, debería de ver siete ele¬ 
mentos en la primera página, junto a un v ínculo Next a una segunda pagina que 
contiene cuatro elementos. Ejecute la aplicación en el dispositivo móvil preferido. 
Como se esperaba, sus primeros siete elementos aparecen en la primera página, 
junto a un v ínculo hacia la siguiente página, como muestra la figura 30.10. 
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Figura 30.10. Los siete primeros elementos de la lista 


El usuario puede hacer clic en el boton Nezt para ver la segunda pagina. En 
la segunda página, no tiene cuatro elementos, como se esperaba, sino siete ele¬ 
mentos. debido a que el control List envolvió los contenidos de la primera 
página en la segunda, como muestra la figura 30.1 1 
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Figura 30.11. Los elementos de la lista restantes se muestran 
en la segunda página. 


Como acabamos de demostrar, cuando la paginación esta activada, se pueden 
aprovechar varias propiedades, como Page. que le permite especificar un nume¬ 
ro de índice de la página que va a ver 
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Resumen 


Hn este capítulo. hemos estudiado los diferentes rasgos de Mobile Internet 
Toolkit. que le permite implementar contenido Web en dispositivos móviles. He¬ 
mos construido varias aplicaciones que demuestran como los controles Web mó¬ 
viles cambian dinámicamente su modo de presentación en tiempo de ejecución, 
dependiendo del dispositivo móvil en el que se esten ejecutando. También hemos 
repasado los modos de detectar las funciones del dispositivo para aprovechar las 
características de varios dispositivos móviles. 

Aunque el capitulo solo ha explicado brevemente algunas de estas característi¬ 
cas. va dispone de un excelente punto de partida para crear contenido Web muy 
dinámico para ser implementado en dispositivos móviles. 
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31 


Cómo 


trabajar con 
ensamblados 


El codigo creado para aprovechar las ventajas de NET Framevvork se compila 
en una unidad de empaquetado llamada ensamblado. Los ensamblados son el 
corazón de la implementación del código y una estrategia de seguridad para NET 
Framework. de modo que es importante entender lo que son y su modo de compor¬ 
tamiento. 

En este capítulo, estudiaremos los ensamblados y como escribir codigo C# 
para trabajar con información en ellos. NET Framework contiene una clase lla¬ 
mada Assembly que hace que trabajar con ensamblados sea algo muy sencillo y 
este capítulo le presenta los entresijos de la clase Assembly. 

Ensamblados 


Los ensamblados pueden contener código, recursos o una combinación de am¬ 
bos. El código de un ensamblado debe contener las instrucciones reales del Len¬ 
guaje intermedio de Microsoft (MSIL) que pueden ser ejecutadas por el Entorno 
común de ejecución (CLR) y un manifiesto que describa el contenido del código. 
Los manifiestos contienen tipos y más información descriptiva que describen el 
código al CLR. Los ensamblados también forman los límites del código encerrado 
entre ellos. Los ensamblados forman los límites de tipos, en los que cualquier tipo 
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que pueda usarse en cualquier código NET procede de un sólo ensamblado y los 
tipos con el mismo nombre procedentes de diferentes ensamblados son. de hecho, 
tipos diferentes. Los ensamblados también forman un limite de seguridad, por 
medio del cual todo el código del ensamblado tiene el mismo conjunto de informa¬ 
ción de seguridad, restricciones y permisos. 

Los ensamblados se empaquetan mediante el archivo ejecutable portable de 
Win32 y pueden ser empaquetados como DLL o EXE. Cualquier código generado 
por un compilador compatible con el CLR y compilado en un ejecutable de conso¬ 
la. un ejecutable Windows o una biblioteca es empaquetado en un ensamblado 
Este paquete forma una unidad de implemcntación para un conjunto de tipos de 
un ensamblado. No piense que sólo se considera ensamblado al codigo NET 
basado en DLL Cualquier paquete de codigo NET. recurso o metadato que tenga 
como objetivo un ejecutable o una biblioteca es un ensamblado, incluso si el 
paquete tiene la forma de un ejecutable Las aplicaciones WinForms. por ejemplo, 
son ensamblados NET válidos, igual que las bibliotecas de clase basadas en 
DLL. Tenga en cuenta que el compilador de C’# también puede generar módulos, 
pero esos módulos no son ensamblados. Los módulos son fragmentos de eódigo (y 
probablemente recursos) compilados que se convertirán en un ensamblado más 
tarde. Los módulos pueden contener MS1L y metadatos que describen los tipos 
que se encontraron en el modulo, pero no contienen un manifiesto. El CLR no 
puede abrir ni ejecutar módulos y por tanto, éstos no pueden ser considerados 
ensamblados. 

Cómo encontrar ensamblados cargados 

Empezaremos a estudiar el concepto de ensamblado escribiendo una pequeña 
aplicación de consola que escribe un poco de información sobre los ensamblados 
cargados en un proceso. Si la información de tipo procede de los ensamblados, el 
CLR debe cargar la información del ensamblado en el espacio de proceso de un 
fragmento de código NET que se esté ejecutando. Por cada tipo al que se hace 
referencia en una aplicación, el CLR debe recuperar información del ensamblado 
que contiene el tipo, de modo que pueda usar el tipo adecuadamente. Estos ensam¬ 
blados reciben el nombre de ensamblados referenaados. porque otro ensam¬ 
blado NET les hace referencia. 

La operación de descubrir la lista de ensamblados a los que se hace referencia 
es un proceso sencillo. Observe la sencilla aplicación de consola del listado 31.1. 

Listado 31.1. Cómo recuperar una lista de ensamblados referenciados 

using System; 

using System.Reflection; 

public class MainClass 

í 
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static void Main ( ) 


{ 

Assembly EntryAssembly; 

EntryAssembly - Assembly.GetEntryAssembly ( ) ; 
íoreach(AssemblyName Ñame in 
EntryAs s e mbly.Get Referen cedA s s emblies () ) 

Consol e . Wr i teT.ine ( "Ñame : { 0 } " , Ñame . ToString () ) ; 



El listado 3 11 presenta muchos conceptos importantes I n primer lugar, pre¬ 
senta una clase NET llamada Assembly. que se incline en el espacio de nom¬ 
bres .System . Ref lection de.NET. Ea clase Assemb 1 y es la clase mediante 
la cual cualquier codigo NET puede examinar y trabajar con los contenidos de un 
ensamblado NET Si necesita trabajar con un ensamblado NET. debe usar la 
clase Assembly para examinar los contenidos del ensamblado. 

El segundo concepto importante del listado 311 es el de ensamblado de entra¬ 
da. El ensamblado de entrada es el ensamblado que se ejecuta en primer lugar en 
el proceso. Para ejecutables, como el ejecutable de consola creado por el listado 
3 1.1. el ensamblado de entrada es el ensamblado que contiene el punto de entrada 
de la función. Normalmente, el punto de entrada recibe el nombreMa in ( ) en los 
ensamblados basados en ejecutables, aunque en C# se puede cambiar mediante el 
argumento /main y especificando otro punto de entrada para el ensamblado. El 
acceso al ensamblado de entrada se realiza mediante un método estático de la 
clase Assembly llamado GetEntryAssembly ( ) . Este método devuelve una 
instancia de un objeto Assembly que hace referencia al ensamblado de entrada. 

El tercer concepto importante del listado 31.1 es el de que un ensamblado 
puede contener ensamblados a los que se hace referencia. La información de los 
ensamblados a los que se hace referencia se obtiene mediante una llamada a un 
método de ensamblado llamado GetReferencedAssemblies ( ) . Este mé¬ 
todo devuelve una matriz de objetos de una clase llamada AssemblyName. Los 
objetos de AssemblyName describen completamente el nombre de un ensam¬ 
blado o se pueden convertir en una sencilla cadena mediante el conocido método 
ToString ( ) . Obtener una representación de cadena de un nombre de ensam¬ 
blado facilita el que las aplicaciones muestren información del nombre del ensam¬ 
blado en las interfaces de usuario. 

Con esta información, resulta sencillo adivinar lo que hace el listado 31.1. El 
código obtiene una referencia al ensamblado de entrada y envía los nombres de 
los ensamblados a los que se hace referencia a la consola. Si se compila y ejecuta 
el código del listado 31.1. se envía la siguiente información a la consola: 

Ñame: mscorlib, Version=1.0.3300.0, Culture = neutral, 

PublicKeyToken = b7 7 a5 c561934e089 

¿Cómo sabe .NET Framework que el listado 31.1 hace referencia al ensambla¬ 
do mscorlib‘ ? Esa información se almacena en el manifiesto del ensamblado 
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del Listado 31.1. Para ver esta información, inicie la herramienta ILDASM de 
NET Framework y abra el ensamblado del listado 31.1 en ella. Haga doble clic 
en la entrada del manifiesto en el árbol que aparecerá y se mostrará el manifiesto 
para el ensamblado en una ventana distinta, como muestra la figura 31.1. 


f MANIFEST 


.assembly extern mscorlib 
< 

. publickeytoken = (B7 7fl 50 56 19 34 E0 89 
.uer 1:0:3300:0 


i§®S9 T • 


^üjbJ *1 


// ,z\U. 4.. 


> I 

.assembly ‘Listing31-1' 

< — 
.custom instance uoid [nscorlib]System.Reflection.flssemblyKeyNameftttribute::.ctor(sti 
.custom instance uoid [mscorlibJSystem.Reflection.RssemblyKeyFileAttribute::.ctor(str 
.custom instance uoid [mscorlibJSystem.Reflection.AssemblyDelaySignAttribute::.ctor(t 
.custom instance uoid [mscorlibJSystem.Reflection.AssemblyTrademarkAttribute::.ctor(: 
.custom instance uoid [mscorlibJSystem.Reflection.AssemblyCopyrightAttribute::.ctor(< 
.custom instance uoid [mscorlib]System.Reflection.AssemblyProductAttribute::.ctor(sti 
.custom instance uoid [mscorlibJSystem.Reflection.AssemblyCompanyAttribute::.ctor(sti^j 

<1___I li 


Figura 31.1. Referencias a un ensamblado externo de un manifiesto 


El manifiesto contiene una entrada con la etiqueta .assembly extern. 
Esa entrada del manifiesto describe un ensamblado externo del que depende el 
ensamblado que contiene el manifiesto. Esta entrada registra que el ensamblado 
que contiene este manifiesto depende de la versión 1.0.3300.0 de un ensamblado 
externo llamado mscor 1 ib. NET Framework debe leer este manifiesto y cargar 
los ensamblados dependientes en el espacio de proceso que se esté ejecutando en 
ese momento. 


NOTA: El ensamblado mscorlib contiene información vital para clases 
como System. Obj ect y siempre se la hace referencia sin ningún argu¬ 
mento especial de compilados. El resto de ensamblados pueden referenciarse 
usando la opción /r para el compilador de líneas de comando de C# o con 
el elemento de menú Agregar referencias de Visual Studio NET. 


Nombres seguros de ensamblado 

El resultado del listado 31.1 puede parecer un poco confuso al principio, ya 
que muestra algo más que el simple nombre del ensamblado, que en este caso se 

llama mscorl ib. 

Este resultado en realidad define cuatro fragmentos de información para el 
nombre del ensamblado: 

• El nombre en si (mscorlib) 

• Un numero de versión ( 1 . 0 . 3300 . 0 ) 
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• Información de referencia cultural (neutral) 

• Un símbolo de clave publica (b'V7a5c5 6 1 9 34eü8 9) 

Como mínimo, todos los ensamblados contienen un nombre, una versión y una 
referencia cultural. Sin embargo, los ensamblados pueden contener una clave 
publica. Un ensamblado que contiene los cuatro fragmentos de información tiene 
un nombre seguro. 

Solo los que contienen nombres seguros pueden almacenarse en la cache de 
ensamblados local. La cache de ensamblados global (GAC) es una colección ba¬ 
sada en disco de ensamblados NET a los que puede acceder cualquier fragmento 
de codigo NET del equipo que contiene el GAC NET Framevvork busca un 
ensamblado en el directorio del ensamblado de entrada cuando debe cargar un 
ensamblado. Este esquema de implementacion es sencillo; sin embargo, puede 
crear vanas copias de un ensamblado en un volumen de disco para los ensambla¬ 
dos mas utilizados, ya que cada ensamblado necesita ser copiado en cada ensam¬ 
blado de entrada que necesite el ensamblado al que se hace referencia. .NET 
Eramevvork incluye la GAC para simplificar las cosas, de modo que los ensam¬ 
blados mas utilizados, como los ensamblados incluidos en .NET Eramevvork. 
pueden ser colocados en un equipo una vez y ser referenciados varias veces. .NET 
Eramevvork comprueba la GAC cuando busca un ensamblado. 

Cuando NET Eramevvork se instala en un equipo, el proceso de configuración 
ínstala una extensión de interprete de comandos del Explorador de Window s que 
hace que la GAC aparezca como una carpeta de Windows estándar. El directorio 
base de Windows, que es C: \WINDOWS en casi todos los equipos, contiene un 
ensamblado de llamada a carpetas en los equipos que tienen instalado NET 
Framevvork. Esta carpeta muestra los contenidos de la GAC. con información de 
nombre seguro en las columnas, como muestra la figura 3 1.2. 

Puede colocar ensamblados con diferentes nombres seguros uno junto al otro 
en la cache de ensamblados global, aunque los nombres de segmento coincidan. 
Por ejemplo, la versión 1.0.0.0 de un ensamblado llamado asscmb 1 y . di 1 pue¬ 
de estar instalada en la caché de ensamblados global junto a la versión 2.().().() de 
un ensamblado también llamado assembly . d 1 i. El codigo que hace referen¬ 
cia a un ensamblado con nombre seguro tiene el nombre seguro del ensamblado 
escrito en el manifiesto y siempre se enlaza al ensamblado con ese nombre seguro, 
aunque otros ensamblados con algunos componentes del nombre seguro sean igua¬ 
les. Si un ensamblado de entrada hace referencia a la versión 1.0.0.0 de 
assembly. dll, por ejemplo. NET Framevvork siempre carga la versión 1.0.0.0 
de assembly. dll en el espacio de proceso del ensamblado de entrada, aunque 
existan otras versiones de assembly .dll en la GAC. La operación de asignar 
la información que compone un nombre seguro es tan sencilla como agregar algu¬ 
nos atributos a uno de los archivos de código fuente para un provecto. Estos 
atributos pueden agregarse a un archivo fuente que contenga código C# o pue¬ 
den agregarse a un archivo distinto que sólo contenga los atributos en sí. 
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Figura 31.2. Vista de la GAC como una carpeta de Windows 


NOTA: VS.NET añade un archivo fuente llamado Assemblylnf o. es 
a los nuevos proyectos de C# y coloca los atributos necesarios para los 
ensamblados de nombre seguro de ese archivo fuente. El nombre de archivo 
puede cambiarse una vez que se ha creado y seguirá funcionando, siempre 
que el archivo renombrado siga siendo parte de la creación del proyecto. 


Cómo asignar la información de versión 

Puede establecer la versión del ensamblado usando un atributo llamado 
AssemblyVersion. Este atributo recibe una cadena que describe el número 
de versión del ensamblado, que es una serie de cuatro números enteros. El primer 
número entero es el número de versión principal, el segundo es el número de 
versión secundaria, el tercero es el numero de compilación y el cuarto es el nume¬ 
ro de revisión. 

Puede especificar los cuatro números para un ensamblado usando el atributo 

AssemblyVersion: 

[assembly: AssemblyVersion("1.0.0.0")] 

Para hacerlo mas sencillo, el compilador de CU genera un número de revisión 
automáticamente si se usa un asterisco en lugar de un número de revisión: 

[assembly: AssemblyVersion ("1.0.0.*") ] 
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Esta sintaxis indica al compilador de CU que debe asignar el numero de revi¬ 
sión que prefiera al ensamblado FJ compilador de CU calcula el numero de segun¬ 
dos entre la medianoche y la hora en que compilo su eodigo. divide el numero 
entre dos y usa el resto de la división como base para generar un numero de 
revisión único. (A esto se le llama operación modulo 2 . ya que una operación de 
módulo calcula el resto de la división entre los dos operandos.) Fsto permite 
generar un numero de v ersión único para cada compilación. 

Para facilitar aún mas las cosas, el compilador de CU genera automáticamente 
un numero de compilación y un numero de revisión si se usa un asterisco como 
numero de compilación: 

[ as s eirtbl y : As s emb 1 y Ve r s i on ( " 1 . 0 . * " ) ] 

Esta sintaxis indica al compilador de CU que debe asignar el numero de com¬ 
pilación y el numero de revisión que prefiera al ensamblado. Ademas del calculo 
automático del numero de revisión descrito, el compilador de CU también calcula 
un numero de compilación usando el numero de dias entre el 1 de enero del 2000 
v el dia en que se produjo la compilación. 

Cómo asignar la información de referencia cultural 

La información de referencia cultural especifica la referencia cultural para la 
que esta diseñado el ensamblado. La información de referencia cultural se especi¬ 
fica mediante un atributo llamado AssemblyCu 1 ture. El atributo de referen¬ 
cia cultural recibe una cadena que describe la referencia cultural para la que se 
diseño el ensamblado. La cadena puede especificarse mediante una cadena vacía 
que informa a NET Framevvork de que la referencia cultural del ensamblado es 
neutral y no contiene eodigo o recursos de una cultura específica: 

[ as semb1 y: AssemblyCulturG ("") ] 

La cadena también puede especificar el idioma y el país para los que se ha 
diseñado el ensamblado. El formato de la cadena que especifica la información 
del idioma y el país debe estar registrado en Internet RFC 1766. que tiene la 
forma idioma-país: 

[assembly: AssemblyCulture("en-ÜS"> ] 


TRUCO: El estándar RFC 1766 recibe el nombre de "Etiquetas para la 
identificación de idiomas" y está disponible en la dirección de Internet en 

http://www .ietf.org/rfc/rfcl766.txt. 


Sólo los ensamblados basados en DLL deben especificar la información de 
referencia cultural. Los ensamblados basados en EXE deben usar una cadena 
vacía para la información de referencia cultural. Si se especifica información de 
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referencia cultural para un ensamblado basado en EXE se produce un error del 
compilador de C#. 

Cómo asignar la información de clave 

NET Framework incline una utilidad de línea de comando llamada la utilidad 
nombre seguro o. para abreviar, sn. que ayuda a crear nombres seguros para los 
ensamblados NET Una de sus características más usadas permite la creación de 
un nuevo conjunto de claves de firma digital que pueden instalarse en un ensam¬ 
blado v ser usadas como parte de un nombre seguro en un ensamblado. Las claves 
están escritas en un archivo binario cuyo nombre se especifica a la utilidad sn 
mediante el argumento -k. como se puede apreciar en la siguiente línea de co¬ 
mando: 

s n k K e y V a i r . s n k 

Esta línea de comando indica a la utilidad sn que debe generar un nuevo par 
de claves de firma digital y enviar las claves a un archivo binario llamado 
Kc ypn i r . snk. Este archivo es nombrado como un argumento para un atributo 

llamado Assemb i yKeyFi-Lo: 

[ ri s s «=■■ rnh I y : As s <:• rnb 1 y Ky r 1 1 e í " K e y Pa i r . sn k " } j 

La extensión . sn| no es imprescindible. Se puede usar cualquier extensión 
para el archivo clav e generado por la utilidad nombre seguro. 

Cómo trabajar con la clase Assembly 

Una vez que conoce la clase Assembly. puede estudiarla más atentamente. 
Las siguientes secciones describen como puede usar sus propiedades y métodos. 

Cómo encontrar la información de ubicación del ensamblado 

La elase Assembly contiene propiedades que describen la ubicación de un 
ensamblado. Una propiedad Location especifica la ubicación del archivo que 
contiene el manifiesto para el ensamblado. Una propiedad CodeBase especifica 
la ubicación de un ensamblado como un Identificado!* de recursos uniforme (URI). 
La propiedad relacionada EscapedCodeBase especifica el URI del ensambla¬ 
do. con caracteres especiales reemplazados por los códigos de escape equivalen¬ 
tes (por ejemplo, los espacios en los valores CodeBase se sustituyen por la 
secuencia de escape 20 en la propiedad EscapedCodeBase). La propiedad 
G1 obalAssembl yCache es un booleano que devuelve True si el ensambla¬ 
do se ha cargado desde la GAC y Eal.se en caso contrario. 

El listado 3 1.2 muestra una sencilla aplicación de consola que obtiene una 
referencia para el ensamblado de entrada de la aplicación y envía su información 
de ubicación a la consola. 
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Listado 31.2. Cómo examinar la información de ubicación 


using System; 

using System.Reflection; 

public class MainClass 
{ 

static void Main() 

{ 

Assembly EntryAssembly; 

EntryAssembly - Assembly.GetEntryAssembly(); 
Console.WriteLine("Location: {0} " , 

EntryAssembly.Location); 

Console.WriteLine("Code Base: {0}", 

EntryAssembly.CodeBase); 

Console.WriteLine("Escaped Code Base: {0}”, 
EntryAssembly.EscapedCodeBase); 

Console.WriteLine("Loaded from GAC: {0}", 

EntryAssembly.GlobalAssemblyCache); 

} 


Si se compila y ejecuta el codigo del listado 3 1 .2 se envía la siguiente informa¬ 
ción a la consola: 

• Location: C:\Documents and Sett ings\User\My 
Documents\Listing31-2 \bin\Debug\Listing31-2 .exe 

• CodeBase: file:///C:/Documents and Settings/User/ 
My Documents/Listing31-2/bin/Debug/Listing31-2.exe 

• Escaped Code Base: f ile : / //C : / Documents 20and 20 
Settings/User/My : 20Documents/Listing31-2/bin/Debug/ 
Listing31-2.exe 

• Loaded from GAC: False 

La información de la ruta varía según la ubicación real del codigo cuando se 
ejecuta, pero los resultados son básicamente los mismos: La propiedad Location 
hace referencia a una posición en el disco y las propiedades CodeBase y 
EscapedCodeBase hacen referencia a la ubicación del ensamblado como URL 

Cómo encontrar puntos de entrada del ensamblado 

Algunos ensamblados tienen puntos de entrada. Imagine un punto de entra¬ 
da como el "método inicial" de un ensamblado. El ejemplo mas obvio de punto de 
entrada de un ensamblado es el método Main ( ) de los ejecutables basados en 
CU. El CLR carga un ejecutable, busca un punto de entrada al ensamblado y 
empieza a ejecutarse con ese método de punto de entrada. 
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Los ensamblados basados en DLL. en cambio, no suelen tener puntos de entra¬ 
da. Estos ensamblados generalmente contienen recursos o tipos usados por otros 
fragmentos de código y son pasivos, en el sentido de que esperan a ser llamados 
antes de que se ejecute algún codigo del ensamblado. 

La clase Assembl y contiene una propiedad llamada EntryPoint . La pro¬ 
piedad EntryPoint es un valor de un tipo llamado Methodlnfo. que se 
incline en el espacio de nombres System. Ref lection .NET. La clase 
Methodlnf o describe los detalles específicos de un método y al llamar a 
ToString ( ) sobre un objeto de tipo Methodlnf o se devuelve una cadena 
que describe el tipo devuelto, el nombre y los parámetros del método. La propie¬ 
dad EntryPoint es nula si la referencia del ensamblado no tiene un punto de 
entrada o un objeto Methodlnf o válido si la referencia del ensamblado tiene un 
punto de entrada, como se aprecia en el listado 31.3. 

Listado 31.3. Cómo trabajar con un punto de entrada de un ensamblado 

usmg System; 

usmg System. Ref lection; 

public; class MainCl as s 

{ 

static void Main(string[] args) 

( 

Assembly EntryAssembly; 

EnLiyAssembly = Assembly.GetEntryAssembly(); 
íf(EntryAssembly.EntryPoint == nuil) 

Consolé .WriteLine ( "The assembly has no entry pomt . ") ; 
e 1 s e 

Conso Le.WriteLine (EntryAssembly.EntryPoint.ToString() ) ; 

} 

} 

Si se compila y ejecuta el listado 31.3 se envía la siguiente información a la 
consola: 

V o i d Main (System.Stnng[ ] ) 

En el sencillo ejemplo del listado 3 1.3. la propiedad EntryPoint nunca es 
nula, pero siempre conviene comprobar la posibilidad de que se produzca un 
valor nulo, especialmente con fragmentos de código más complicados. 

Cómo cargar ensamblados 

En muchas aplicaciones, a los ensamblados que contienen los tipos necesarios 
para una aplicación se les hace referencia cuando se crea la aplicación. Sin em¬ 
bargo. también es posible cargar los ensamblados mediante programación. Elay 
varios modos de cargar un ensamblado dinámicamente y cada una de estas técni- 
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cas de carga devuelve un objeto Assembly que hace referencia a un ensamblado 
cargado. 

La primera técnica de carga de ensamblado usa un método de ensamblado 
estático llamado Load ( ) . El método Load { ) recibe una cadena que proporcio¬ 
na el nombre del ensamblado que se va a cargar. Si no se encuentra el ensamblado 
nombrado, el método Load ( ) inicia una excepción En cambio, el método 
LoadWi thPartialName ( ) busca el directorio de la aplicación y la GAC del 
ensamblado especificado, usando toda la información de nombre disponible para 
el invocador. El listado 3 1 4 muestra la diferencia entre estos dos métodos. 

Listado 31.4. Cómo cargar ensamblados dinámicamente con Load() y 
LoadWithPartialName() 


using System; 

using System.Reflection; 

using System.10; 

public class AssemblyLoader 

{ 

prívate Assembly LoadedAssemb1 y ; 

public AssemblyLoader(string LoadedAssemblyName, bool 
PartialName) 

{ 

t r y 

{ 

Consolé .WriteLine ( " +-" ) ; 

Consolé .WnteLine ( " | Loading Assembly {0}", 
LoadedAssemblyName); 

Consolé .WriteLme ( " +-" ) ; 

if { PartialName == truel 
LoadedAssembly = 

Assembly.LoadWithPartialName(LoadedAssemblyName); 
e 1 s e 

LoadedAssembly = Assembly.Load(LoadedAssemblyName); 
WritePropertiesToConsole ( ) ; 

} 

catch(FileNotFoundException) 

í 

Consolé.WriteLine("EXCEPTION: Cannot load assembly.' 1 ); 



prívate void WritePropertiesToConsole() 

{ 

Consolé.WriteLine("Full Ñame: {0}", 
LoadedAssemb1y.FullName); 

Consolé.WriteLine ("Location: {0} ", 

LoadedAssembly.Loeation); 

Consolé.WriteLine("Code Base: {0)", 
LoadedAssembly.CodeBase); 
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{0} 


Consolé.WriteLine{"Escaped Code Base: 
LoadedAssembly.EscapedCodeBase) ; 

Consolé.WriteLine("Loaded from GAC : 
LoadedAssembly.GlobalAssemblyCache); 



public class MainClass 

{ 

static voíd Main(string[ ] args) 

{ 

AssemblyLoader Loader; 

Loader = new AssemblyLoader("System.Xml, 
Version-1.0.3300.0, Culture^neutral, 

PublicKeyToken=b77a5c561934e089 " , false) ; 

Loader = new AssemblyLoader("System.Xml", false); 
Loader = new AssemblyLoader("System.Xml", true); 

} 

} 


El listado 31.4 muestra una clase llamada AssemblyLoader. cuyo cons¬ 
tructor recibe un nombre de ensamblado y un indicador booleano que especifica si 
el ensamblado nombrado debe cargarse usando un nombre parcial. El constructor 
carga el ensamblado y a continuación llama a un método privado para escribir 
algunas de las propiedades de designación y de ubicación del ensamblado cargado 
en la consola. 

El método Main () del listado 3 1.4 crea nuevos objetos de la clase 
AssemblyLoader e intenta cargar el ensamblado de NET Framework 
System. XML. que se encuentra en la GAC. de varios modos. 

Si se ejecuta el listado 3 1 4 se escribe la siguiente información en la consola: 

H- 

| Loacling Assembly System.Xml, Ve r s ion= 1.0 . 3 3 0 0.0 , 

Culture=neutral, PublicKeyTok 
en=b77a5c561934e089 
+- 

Fuli Ñame: System.Xml, Versión-1.0.3300.0 , Cultu r e = neut r a1, 

PublicKeyToken=b7 7a5 
c 5 6 1 9 3 4 e 0 8 9 

Location: c: \windows \assembly\gac\system.xml\1.0.3300.0_ 

b7 7 a 5 c 5 1 19 3 4 e0 8 9 \ s y s t. em 
.xml.di1 

Code Base: file: ///c: /wmdows/assembly/gac/system.xml/ 

1.0.3300.0 b 7 7 a 5 c 5 619 3 4 e 0 
8 9/system.xml.dll 

Escaped Code Base: file: ///c: /wmdows/assembly/gac/system.xml/ 

1.0.3300.0_ b7 7 a5 c 
5 619 3 4 e 0 8 9/s ys t em.xml.dll 
Loaded from GAC: True 
+- 
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| Loadme] Assembly System. Xml 


EXCEPTION: Carino t load assembly. 


I Loading Assembly System.Xml 


Ful 1 Ñame: System. Xml, Ve r s i oíu 1 . 0 . 3 3 0 0.0 , Cultur e-neutn 1 , 

P ub 1 1 c K e y T o k e n - b 7 7 a 5 
c 5 c 19 3 4 e 0 8 9 

Location: o:\Windows\as semb1 y\gac\sys tem.xml\1.0. 1100.0_ 

b 7 7 a 5 c 5 c19 3 4 e 0 8 9 \systcm 
.xml.dll 

C o d e Base: file: / // c: / w and o w s / a s s e mb 1 y / g a o / s y s tem. m i / 

U >'i , 3 30 0 . C b 7 7 a 5 o 8 7 1 9 3 4eü 
8 c - / s y s 1' e:n. x m 1 . d 1.1 

E s o a p e d c o d e B a se: file : // / c : / w ind ow s /. i s s anb ; y / g a o / s y s t. e m . x m i / 
i . U . 3 3<¡0 . 0 li7 7a.Sc 
7 : ° 7 .-a') R o / s ys t em. xml . di 7 

i. a ■ i e d f i om GAC : T i u e 

Observe con atención lo que se esta produciendo. Hn el segundo caso, el méto¬ 
do Mú i n { ; especifica e! nombre seguro para el ensamblado Sys t en. . 

ineluxendo su nombre. clave publica, información de \cisión \ detalles específi¬ 
cos de su referencia cultural C omo el ensamblado dy s tem. Xm 1 esta en la 
GAC. no se almacena en el directorio de la aplicación \ el método boa 1 no 
puede encontrar el ensamblado en el directorio que contiene el ejecutable del 
listado 3 1.4. Sin embargo, como se especifico el nombre seguro para el ensambla¬ 
do. el método Load ( ) tiene suficiente información para buscar el ensamblado en 
la GAC. H1 método Load y) puede encontrar el ensamblado en la GAC \ la 
operación de carga se completa con éxito. Hn el segundo caso, el método Md i n : ) 
solo especifica el nombre base del ensamblado SystcnuZm^. Como el ensam¬ 
blado System. Xml esta en la GAC. no se almacena en el directorio de la apli¬ 
cación \ el método Load ( ) no puede encontrar el ensamblado en el directorio 
que contiene el ejecutable del listado 3 1.4. Ademas, el método Load ¡; ) no tiene 
suficiente información para ubicar el ensamblado en la GAC. ya que pueden 
existir muchas instancias de System . Xml en la GAC con diferentes números de 
versión o claves publicas, por lo que la carga falla. 

Hn el tercer y último caso, el metodoMain ( ) solo especifica el nombre base 
del ensamblado System . Xml e indica al cargador que encuentre un ensamblado 
usando sólo un nombre parcial. De nuevo, como el ensamblado System. Xml 
esta en la GAC. no se almacena en el directorio de la aplicación y el método 
LoadWithPart ia iName ( ) no puede encontrar el ensamblado en el directo¬ 
rio que contiene el ejecutable del listado 3 1.4 Sin embargo, el método 
LoadWithPartialName ( ) recibe el nombre parcialmente proporcionado e 
intenta hacer coincidir el nombre con un ensamblado de la GAC Como se ha 
proporcionado un nombre parcial de System. Xm J y hay un ensamblado con el 
nombre System. Xml en la GAC. la operación de carga se completa con éxito. 
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ADVERTENCIA: No se recomienda utilizar LoadWithPartialName (). 
Si el ensamblado parcialmente nombrado tiene varias copias en la GAC 
(quizás con diferentes números de versión, referencias culturales o claves 
públicas) la instancia realmente cargada puede no ser la versión esperada. 
Además, la instancia cargada puede ser una versión diferente de la que 
pretendía cargar después de que se hayan cargado versiones más moder¬ 
nas en la GAC. Use Load () en lugar de LoadWithPartialName () 
siempre que pueda. 


Cómo trabajar con información de tipo de ensamblado 

Los ensamblados pueden contener tipos, recursos o una combinación de am¬ 
bos Tras cargar un ensamblado, se puede obtener información sobre los tipos que 
se encuentran en el ensamblado. Ademas, se pueden crear instancias de los tipos 
mediante programación bl listado 31.5 muestra estos conceptos. 

Listado 31.5. Cómo encontrar y crear tipos de ensamblado 

using System; 

using System.Fefier;t i on ; 

publie clas s Mai nC 1a s s 
{ 

static v o i. d M am ístrmg [] a r g s ) 

{ 

A s s e mb 1 y XM L A ss e mb 1 y ; 

Type[ ] XMLTypes ; 

XMI,As s emb 1 y - As s emis 1 y . Load ( "System. Xmi, 

Versio n-§4 0. 1 33 Ü.0, Cult uie=neutral, 

P u 1) .1 i c Y e y T o k e n - b 7 7 a h c b t. I 9 3 4 e 0 8 9 " ) ; 

XMLTypes - XMLAssemb1 y.G e t E x p o r t e d Types () ; 
toreaoh(Type XMLType m XMLTypes) 

{ 

(d") j e o t U e wO b j e ct ; 
t r y 


C: on s ole. W rite ( XMLTyp e.ToStrmg ( ) ) ; 

Nev/Ob 'i ect. = 

XML As sernb 1 y . C r e atol ns t anc e (XMLType . ToS t r ing ( ) ) ; 
i f (NewOb -j e c t. ! ~ nu .11) 

Consol e ,.Wr i t eL i ne ( " - Crcatio n success f u 1 " i ; 
e 1 s e 

Consolé.WnteLme (" - CREATTON ERROR”) f 

} 

cat.ch (' Exoept i on e ) 

{ 

C on s o ie * W rit e Tone ( " - EXC E PTION; {0)", c.Mcssage) ; 
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} 


Ll código del listado 3 1.5 carga el ensamblado ixysron. Xrr. , desde la GAC 
y llama a un método en la clase Asserr.b 1.y llamado (Krt.Kxeer t.ú:iTyt;.o? 

para conseguir una matriz de objetos de tipo que representan los tipos que se 
encuentran en el ensamblado y pueden ser utilizados o exportados al exterior del 
ensamblado. Ll código recorre cada tipo de la matriz de\ uelta e invoca a otro 
método de ensamblado llamado Crear e Insta-rico i para crear una instancia 
de objeto del tipo nombrado. Si la creación se realiza con éxito, el método 
Crcatelnstance ( } devuelve una referencia de objeto \a 1 1 da Si la creación 
no tiene éxito. Crcatelnstance ( ) devuelve una referencia de objeto nula o 
inicia una excepción, dependiendo de la naturaleza del error 

A continuación tiene varias líneas de resultado del listado 3 1.5: 

S y s tem. X m 1 . X P ath . X P a t h N a v i g a t o r - E X C E P TIOIJ: O o í| .y 1 1 u ■: t u i r,: i 
t ype S ys t em. Xm 1 . XPat h . X PathNavi gato r not. í oui:ci . 
o y s t em. Xm 1 . IHa s Xm.lNode - EXCE PTI ON : C on s t r u o t.. c r ot: | y \> 

Syst em. Xml. IHasXmlNode not 1 ounel. 

S y s t e m. X mi . X Pat h . X Pat hNode Iterat o r EX C E P T T Gl|: C j i i s t ni 1. o r o r. 

t y p e S y s t. em. Xm 1 . X P a t h . X P a t h Mod a T t e r a t. o r n o t. í o und . 

X y ate m . X m 1. . E n t i t y H and 1 i n g C r e a t i o n s u c c < :• s a í u 1 
S y st em. X m I .IXmiLineTnfo - EXCEP TION: Construótaf o 11 ty pe 
S y s t e rn . X mi . T X mlLinelnto n o t. f o u n d . 

Systenu Xml . Xml NameTab 1 e - EXCEPTTON : Cor.s 1 1 uct or on t ype 
S y s t e ni. Xm 1 . Xm 1 M a me Tabl e not f o un d . 

Sys tem.Xm1 .Na me Table - C r eation suc c e s s f u1 
System.Xmi .ReadStat e - Creation su cc es s i u1 
System. Xm 1. . Va 1 i dati onType -- Creati on succes s f uf. 

5iys t em . Xml . Wh i t espaceHand 1 1 ng Creati on suecos sfu 1 

Las excepciones se producen porque no todos los tipos exportados tienen cons¬ 
tructores y con Createlnstance ( ) solo se pueden crear tipos de referencia 
con constructores adecuados. 


TRUCO: Tras obtener una referencia a un objeto Type, se puede encon¬ 
trar una referencia al ensamblado que contiene el tipo en la propiedad 
Assembly del objeto Type. Esto permite al código descubrir el ensam¬ 
blado que hace referencia a un tipo. 


Cómo generar código nativo 
para ensamblados 


Cuando el CLR necesita ejecutar codigo en un ensamblado, pasa el código a 
través de un compilador justo a tiempo (J1T) y devuelve el MSIL a un codigo 


689 






ilativo que puede ser ejecutado por la CPU del equipo. La ventaja del diseño J1T 
es que es posible enviar código MSIL sin tener que preocuparse por optimizar el 
código para el procesador al que esta destinado. NET Framework probablemente 
sera exportado a una gran variedad de arquitecturas de CPU de una gran variedad 
de dispositivos, desde equipos de sobremesa hasta sistemas portátiles e intentar 
escribir codigo para cada una de estos procesadores podría ser una tarea impre¬ 
sionante. 

Este trabajo no es necesario porque cada implementación de .NET Framework 
tiene un compilador JIT que convierte las instrucciones MS1E en instrucciones 
óptimas para la C PU de destino. 

Si la principal preocupación de su aplicación es el rendimiento, puede conver¬ 
tir el codigo MSIL en eodigo especifico para la C PU de un equipo mediante un 
proceso conocido como generación de imagen naliva. Durante este proceso, las 
instrucciones MSIL de un ensamblado se convierten en instrucciones especificas 
de una C PU. que pueden ser escritas en disco. Después de completar esta gene¬ 
ración de imágenes nativas, el CLR puede usar este código y puede omitir el paso 
JIT que normalmente se emplea en los ensamblados. 

.NET Framework incluye una herramienta llamada Generador de imáge¬ 
nes nativas, que genera una imagen nativa para un ensamblado. Esta herramien¬ 
ta de linea de comando se encuentra en un ejecutable llamado r,•;• • i:. • : - • v 
recibe como entrada un nombre de ensamblado: 


La imagen nativa se coloca en una cache de imágenes nativas para ensambla¬ 
dos Tenga en cuenta que n jn debe ejecutarse en el dispositivo que ejecuta el 
codigo generado Por ejemplo, no puede construir ensamblados como parte de su 
proceso de compilación, ejecutar nqen sobre esos ensamblados y env iar esas 
imágenes nativas a sus clientes. 

El equipo en el que se compila puede perfectamente tener una CPU diferente 
de la de los equipos de sus clientes y rigen genera codigo para la CPU en la que 
nqen se esta ejecutando. Si para sus clientes es importante tener imágenes na¬ 
tivas para sus ensamblados, debe ejecutar nqen en los equipos de sus clientes 
como parte del proceso de instalación. 

También es importante tener en cuenta que los ensamblados .NET originales 
deben estar disponibles en todo momento, aunque el código nativo este disponible 
en la cache de imagen nativa. 

Fas imágenes nativas son archivos Ejecutable portables (PE) Win32 estándar 
\ carecen de los metadatos existentes en un ensamblado .NET. Si el codigo carga 
su ensamblado de imagen nativa y ejecuta código que obliga a NET Framework 
a examinar metadatos (por ejemplo, usando reflexión para obtener información 
para el ensamblado), entonces el ensamblado NET original debe estar disponible 
para que el CLR pueda consultar sus metadatos. Eos metadatos no pueden ser 
transportados junto a la imagen nativa. 
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Resumen 


En este capítulo, se ha examinado el concepto de ensamblado NET desde la 
perspectiva de las aplicaciones de C# que pueden acceder a la información de los 
ensamblados. El acceso a la información de los ensamblados se realiza mediante 
la clase Assembly. La clase Assembly muestra la información de nombre 
para el ensamblado y permite que los ensamblados se carguen dinámicamente. 
Los tipos gestionados por el ensamblado pueden ser creados al instante. 

Puede aplicar los conceptos mostrados en este capítulo en la construcción de 
potentes aplicaciones .NET. Algunas de las herramientas que incorpora NET 
Framework. como la herramienta 1LDASM. usan una combinación de métodos de 
la clase Assembly y otras clases en el espacio de nombres System. 
Ref lection para proporcionar una vista con todos los detalles de los ensam¬ 
blados ya compilados. Se puede obtener una gran cantidad de información de los 
ensamblados, usando los métodos de la clase Assembly y otras clases de re¬ 
flexión. aunque el código fuente usado para construir el ensamblado no este dis¬ 
ponible. 
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32 


Reflexión 


Una importante característica de NET Framework es su capacidad para des¬ 
cubrir información de tipo en tiempo de ejecución. En concreto, puede usar el 
espacio de nombres reflection para ver la información de tipo que contienen 
los ensamblados que. mas tarde, podrá enlazar a objetos e incluso puede usar este 
espacio de nombres para generar codigo en tiempo de ejecución Esta tecnología 
se extiende a la tecnología de automatización COM. ya conocida por muchos de 
los leetores. 

Como programador, seguramente necesite usar a menudo un objeto sin com¬ 
prender del todo lo que hace ese objeto. La reflexión permite tomar un objeto y 
examinar sus propiedades, métodos, exentos, campos y constructores, ( orno la 
reflexión gira en torno a System. Type. puede examinar un ensamblado y usar 
métodos, como GetMethods ( ) y GetProperties ( ) . para devolver infor¬ 
mación de miembro desde el ensamblado. Con esta información, puede empezar 
usando el método MethodInf o ( ) para devolver listas de parámetros e incluso 
llamar a métodos en el ensamblado con un método llamado Invoke. 

En este capítulo, aprenderá a usar el espacio de nombres Ref lect ion para 
examinar objetos en tiempo de ejecución. También aprenderá a enlazar tardía¬ 
mente los objetos y a usar métodos y propiedades en estos objetos enlazados 
tardíamente. 
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La clase Type 


La clase Type actúa como una ventana al API de reflexión, lo que permite el 
acceso a metadatos. La clase abstracta System. Type representa un tipo del 
Sistema completo de tipos (CTS). Este sistema completo de tipos es lo que permi¬ 
te examinar objetos en todos los lenguajes de la familia NET Como cada objeto 
usa el mismo entorno, tiempo de ejecución y sistema de tipos, la información de 
objeto y de tipo se consigue fácilmente. 

Una de las mayores ventajas de las clases Type es su capacidad para crear 
objetos dinámicamente y usarlos en tiempo de ejecución. 

Cómo recuperar información de tipo 

La información de tipo puede ser recuperada de los objetos mediante varios 
métodos. Las siguientes secciones describen cómo hacer esto de tres maneras 
diferentes: usando un nombre de tipo, usando un nombre de proceso o especifi¬ 
cando un nombre de ensamblado para recuperar la información. Aunque todas 
estas implementaciones realizan prácticamente la misma tarea, cada una es útil a 
su manera 

Dependiendo de los requisitos de su aplicación, sólo necesitará usar una de las 
formas de las funciones recolectoras de tipos. 

Cómo recuperar tipos mediante el nombre 

Simplemente especificando el nombre de un tipo, puede consultar casi todos 
los aspectos del objeto. Puede determinar si el objeto es una clase, de qué tipo es 
su sistema base y muchas otras propiedades. 

Para comprobarlo, puede crear una sencilla aplicación para ver algunas pro¬ 
piedades de la clase System. St ring. como muestra el listado 32.1. 

Listado 32.1. Cómo consultar información de tipo mediante el nombre 

using System; 

using System. Reflection; 

class NameType 

{ 

public static void Main() 

{ 

Type t. = Type . GetType ( "System. St ring" ) ; 

Consolé .WnteLme ( "Ñame : {0} ", t .Ñame) ; 

Consolé .WnteLine ( "Underlymg System Type : 

{ 0 } " , t . Under lyingSys t.emType ) ; 

Consolé .WnteLme ("Is Class : { 0} " , t . IsClass) ; 

} 

} 
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La figura 32.1 indica que System. Strmg es el tipo de sistema base y que 
el objeto es. sin lugar a dudas, una clase. 

Se estará preguntando que utilidad tiene esta información. Imagine que esta 
creando una aplicación que necesita generar instrucciones i nsc r t. para introdu¬ 
cir información en SQL Server. Escribir una gran cantidad de información re¬ 
quiere una gran cantidad de tiempo. Usando la reflexión y la elase Typo. puede 
examinar el tipo subyacente de cada fragmento de información que quiera insertar 
en SQL. Server y describir estos tipos a un tipo de datos SQL Server valido Listo 
simplifica mucho el proceso de generar mediante programación las instrucciones 
insert que necesita. 



Figura 32.1. Información de tipo de consulta mediante un nombre de objeto 


Cómo recuperar tipos mediante instancias 

En lugar de usar el nombre de un tipo, puede simplemente usar una instancia 
de un objeto que quiera examinar. El listado 32.2 representa un ejemplo igual que 
el anterior. 

Listado 32.2. Información de tipo de consulta usando una instancia de un objeto 

using System; 
using System.Relieo1 1 on ; 

c 1 a s s I n s t a n c e T y p e 
{ 

pub 1 i r: s t a t. i c v o í d Main ( ! 

{ 

String myVa r = "Brian Patteison"; 

Type t = myVar.GetType ( i ; 

Consolé .WnteLine ( "Ñame : { 0 ) " , t . Mame ) ; 
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} 


e 1 


‘: o 1 ' S r > i r- . W r i t e í. i n e ; " ! 5 n •" 1 e r i y i l' g a y y t e m T y p o : 
r . Umie r i y i r. g S y s t emType ;■ ; 

<:e n .y o ; e . W r i f ^ 1 .1 n e :"! y C; 3 a .s y : { 0 } " , t . I s C ] a s s 


En este ejemplo, en lugar de especificar que quiere ver la información de tipo 
de ro/r-:f o:t¡ . r.r r i nq. se crea una instancia de una \ariable de cadena sobre la 
que. a continuación, llama al método GetType ( ) . l a información obtenida 
aquí es la misma que la que se obtuvo en el ejemplo anterior, la diferencia esta en 
que no tiene que saber el tipo antes de tiempo Simplemente llame al método 
GeTTypo y asígnelo a un objeto Type. al que puede consultar el nombre, el 
tipo de sistema subyacente y similares. 

Cómo recuperar tipos en un ensamblado 

A menudo, querrá examinar los tipos que contiene un ensamblado. Este en¬ 
samblado puede ser un ejecutable o incluso una biblioteca de vínculos dinámicos 
contenida en el sistema. El listado 32.3 contiene el codigo necesario para exami¬ 
nar la información de tipo del propio ejecutable. 

Listado 32.3. Cómo examinar un proceso en ejecución para obtener información 

de tipo 


u.s inq S y.s t em; 

u.s i n q S y s t e m. R e :| 1 e c t i o n ; 

iis! r.q S y stem. D .1 agno s 1 1 cs ; 


o ] a s y A s s e m T y p e 
I 


pub 3 1 *•; s r a t : r: y 1 r\ Ma 1 n ( s t r mg[ ] a r g.s ) 

{ 

i- 1 r o o <=* s s p - F r o c ess . G e t C u rrentPro c e s s ( ) ; 
s t r ■ n g a s s; emh 1 yl Jame - p. Proce s s N ame + " . e e " ; 

f :'.-11 s M e . W r i f e í, 1 n e <" ” Ka mimng : { 0 } as s o mb 1 y N a m e i ; 

A\ s s; em! •; y a • • A s sem b 1 y . Lo a c 1 F r o m ( a s s e mb 1 y N a m e ) ; 

Type ( lytypes - a . GetTypes ( ) ; 
t o reah 'Type t 1 n 1“ yp e s ) 
i 

(: r. s o 1 e . VJ r ■ r e L mi e [ " \ n T yp e : ( 0 } " , t . FuJpLN ame • ; 

;: o r. s o ! e . VJ r' : t ep 1 n e ; " \ t B a s e r; 1 a s s : 

; , t . RasoTyp “• . Fu ¡ ! I Ja me ) | 


3 

} 

El codigo anterior presenta algunos elementos nuevos. El tipo process se 
usa para examinar procesos que se están ejecutando. En este contexto, se emplea 
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para conseguir el nombre ele su programa y luego agrega . - al final del nom¬ 
bre para que pueda examinar el ensamblado. Puede igualmente escribir en el 
eodigo el nombre de su aplicación, pero este método garantiza que funcionara, sin 
que importe como llame a su aplicación.. 

La figura 32.2 muestra el resultado de esta aplicación No es un resultado mu\ 
espectacular, va que su programa solo contiene una clase 

x ¡ 1 


y 

Figura 32.2. información de proceso obtenida mediante el API Reflection 

C omo puede ver en el figura 32 2. hemos examinado el proceso en curso y la 
misma aplicación que esta ejecutando y hemos mostrado todas sus clases internas 
y sus tipos. Para experimentar, intente agregar algunas clases nulas a este proyec¬ 
to y luego vuelva a ejecutar la aplicación Debería ver una lista de todas las clases 
que allí se contienen y sus tipos. 

Cómo interrogar a objetos 

El listado 32.4 contiene el codio fuente de la aplicación Re f^ect ionTcst:. 
que examina una clase y proporciona detalles sobre ella. Esta aplicación en un 
conglomerado de todo lo que ha aprendido sobre la reflexión hasta el momento. 

Listado 32.4. Los objetos de clase proporcionan fácilmente la información 

de miembro 


i fckJ AV.’J , .r-iOl 


C:\>AssemblyTypes.exe 
Examirting : AssemblyTypes.exe 

Type : ftssemType 

Base class : System.Object 

C:\>. 


namespace ReflectionTest 
{ 

using System ; 

using System.Reflection 

public class Classl 
{ 
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pun 1 ic .s tciUc int Ma in ( i 


T y p i? t - L y p e o f i a U s e í U1C 1 a s s ) 

Consolé.WriteLinc ( "Type of class: " + t | 

Cmi.so i o . WriteLine { " Ñame sp ¿ice : " + t.Name.space - 

C o 11 s r r a c f o rlnfo [ ] c i - t . G e t Cons t r u ctor s ( ) ; 

Con.sole.WiiteLine i" - ■ - 

(: ons oie.WriteLine ( "Constructors are:" ) 

t oreachí Constructorlnfo i in ci ) 

I 

Co 2 i.s o 1 e . Writ eLine ( i ) 

} 

PropertyInfo: ] pi - t.GetProper ti es ( ) ; 

C on soIe.WriteLme ( "-- 


C o n s o 1 e . VJ r 1 1 e L i ne ( "Properties are:" ) 

for ea r j h ( ír oper t y Tnfo i ni pi ) 
í 

Consolé .Wr íteLmef i | 

} 

MethodTnfo í j mi - t.. GetMethods. ( ) ; 

C on s o i e . Wr i f eTiine ( "Meth ocl.s a re: " ) 

■ or e a c h i M e t h o el Inf o i i n mi ) 

I 

Con.so 1e.WriteLine ( "Ñame: " + i.Ñame ) ; 

P a rame terlnfo[ ] pif = i.GetParame t e r s í} ; 

f o r e a o h. i P ara me t e r. I n f o p in p i f ) 
f 

C ons o 1 e . Wr i t. e L i ne ( " Type : " + p . Pa r ame t e r Type 

pararneter ñame: " + p. Ñame ) 

} 

ret.urn 0 ; 

| 

p ub1 1 c cia s s a UsefulClass 

I 

public int publnteger ; 
prívate int privVa 1ue ; 
public aUsefulClass ( ) 

( 

) 

public aUsefulClass ( int IntegerValúeIn ) 

{ 

publnteger = IntegerValueln ; 
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} 


public int AddlO ( int IntegerValúeIn ) 
{ 

Consolé .WnteLine ( IntegerValueln ) 
return IntegerValueln + 10 ; 


public int TestProperty 
{ 

ge t 
{ 

return _privValue 

} 

set 


_privValue = valué 

} 


} 


} 


} 


Aquí hemos creado dos clases. Cíassi y aUsefulClass. Cías si con¬ 
tiene el principal punto de entrada a su aplicación (void Main) . mientras que 
la otra clase solo existe para ser examinada. 

Para examinar la clase aUsefulClass. realice los siguientes pasos en el 
procedimiento principal: en primer lugar, declare un objeto Type y. mediante la 
palabra clave typeof. diríjalo hacia aUsefulClass. A continuación, mues¬ 
tra la clase Type y el espacio de nombre. 

Después, use GetConstructors para recuperar una lista de los construc¬ 
tores de la clase. A continuación, aplique un bucle a lo largo de los constructores 
y muéstrelos en la pantalla. Al igual que con los constructores, use 
GetPropertíes para recuperar una lista de todas las propiedades de modo 
que puede iterar a lo largo de la lista y de las propiedades fuera de la ventana de 
consola. 

GetMethods recupera todos los métodos, además de los métodos que com¬ 
ponen los descriptores de acceso get y set de sus propiedades. A continuación, 
se itera a lo largo de esta información y ésta se muestra en pantalla. También 
invoca a Get Par ameter s para que recupere una lista de los parámetros para 
cada método y también muestra esa información 

Como puede ver en la figura 32.3. su aplicación muestra una gran cantidad de 
información sobre el objeto de la clase. 

Obviamente, esta aplicación no es especialmente útil, ya que ya tiene el eodigo 
fuente de la clase en cuestión y no necesita la reflexión para darle detalles. Lo 


699 



importante aquí es que la reflexión funciona de la misma manera, aunque estemos 
tratando con un ensamblado para el que no tengamos el codigo fuente. 


cA C:\WINPOWS\System32\cmAexe ' 

C:\>RefleetionTest.exe 

Type of class: Ref lect ionTest. Classl+allsef ulClass 
Namespace: ReflectionTest 


Constructors are: 
Uoid .ctoi*() 

Uoid .ctor<Int32> 


Properties are: 
Int32 TestProperty 


Methods are: 

Ñame: GetHashCode 
Ñame: Equals 

Type: System.Object parameter ñame: obj 
Ñame: ToString 
Ñame: Rddl@ 

Type: System.Int32 parameter ñame: IntegerUalueIn 
Ñame: get_TestProperty 
Ñame: set_TestProperty 

Type: System.Int32 parameter ñame: valué 
Ñame: GetType 

|C:\> _ 


Figura 32.3. Las clases Peí lect .ion y Type revelan una gran cantidad 
de información relativa al objeto de la clase 


Cómo generar código dinámico mediante 
la reflexión 

Puede crear codigo en tiempo de ejecución usando el espacio de nombres 
System. Pof 1 oc;ti on . Flmi t. Al usar las clases de este espacio de nombres, 
se puede definir un ensamblado en la memoria, crear un modulo, definir nuevos 
tipos para un módulo (incluyendo sus miembros) y emitir códigos de operación 
MSIL para lógica de la aplicación 


NOTA: "Opcodes" es la abreviatura de códigos de operación. Éste es el 
código real que genera el compilador de NET. 


H1 listado 32.5 contiene el código que puede usarse para generar codigo en 
tiempo de ejecución. 

Listado 32.5. Cómo generar código dinámicamente en tiempo de ejecución 

using System; 

us i n g System.Reflection; 

using System.Reflection.Emit; 

namespace DynamicCode 

{ 


700 













c lass CocleGenerator 


Type t; 

Ap p Domain currentDomain; 
Assemb.1 yName assemName; 

As s emb 1 y Bu i Ider a s s emBu i.lcler; 
Mo du1e B uiIder modu1e B uiIder; 
TypeBuilder typeBu i 1 der; 
MethodBuiLder methodBuilder; 

ILGenerator msilG; 


pu b 1 i c: s t a t ir: v o i d Ma i n í ) 

( 

CodeGenerator c ode Gen - new CodeGenerat or (' i ; 

Type t = codeGen.T; 

i f (t. ! = nuil) 
f 

object o = Activator .Createlnst anee (t. ) ; 
Methodlnf: o hel XoWor 1 d - t . GetMet hod ( "He í 1 oWo t.,|ci 
íf (hel. loWorld != nuil) 

{ 

// Ejecuta el método He 11 oWo r 1 d 
he 11 oWor 1 d.Invoke ( o, nu 11 ) ; 

} 

e 1 s e 

{ 

Consolé .WriteLine ( "Coulcí not retrieve 

Methodlnfo"); 


e 1 s e 

{ 

Consolé.WriteLine("Could not aceess the Type"1; 

} 


public CodeGenerator ( ) 

{ 

// Obtiene el dominio de aplicación actual. 

// Esto es necesario cuando se construye codigo. 
currentDomam - AppDomain . CurrentDomam ; 

// Crea un nuevo ensamblado para nuestros métodos 
assemName - new Assemb1yName(); 
assemName.Ñame = "BibleAssembly"; 

assemBulíder = 

currentDomain.DefineDynamicAssemb1 y(assemName , 
AssemblyBuilderAccess.Run); 
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// Crea un nuevo módulo en este ensamblado 
moduleBuilder = 

assemBuilder.DefineDynamicModu1e("BibleModule"); 

// Crea un nuevo tipo en el módulo 
typeBuilder = 

moduleBuilder .DefmeType ( "BibleClass" , TypeAt tributes .Public) ; 
// Ahora podemos agregar el 

// método HelloWorld a la clase recién creada. 
methodBuilder = 

typeBuilder.DefineMethod("HelloWorld”, 

MethodAttributes.Public,nuil,nuil); 

// Ahora podemos generar algo de código de lenguaje 

// intermedio de Microsoft que simplemente escriba 

// una linea de texto en la consola. 

msilG = methodBuilder.GetlLGenerator() ; 

ms i1G.EmitWriteLine("Helio from C# Bible"); 

msi1G.Emit(OpCodes.Ret); 

// Crea un tipo, 
t - typeBuilder.CreateType() ; 

} 

public Type T 

{ 

ge t 


return 


this.t; 


Como se esperaba, esta aplicación sólo escribe un mensaje en la consola, como 
muestra la figura 32.4. 

La función dereflexión para generar objetos y código en tiempo de ejecución es 
realmente impresionante y constituye la columna vertebral para la generación de 
aplicaciones de lógica difusa que se adaptan y aprenden como resulte apropiado. 


NOTA: La lógica difusa es un tipo de álgebra que usa los valores verdade¬ 
ro y falso para tomar decisiones basándose en datos imprecisos. La lógica 
difusa suele relacionarse con los sistemas de inteligencia artificial. 


Resumen 


Las clases Ref lection y Type van unidas cuando necesita descubrir in¬ 
formación de tipo en tiempo de ejecución. Estas clases permiten examinar obje- 
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tos. cargar objetos dinámicamente en tiempo de ejecución e incluso generar códi¬ 
go en caso de necesidad. 


C:\>DynanicCode.exe 
Helio fron Ctt Bible 


C:\> 



Figura 32.4. Los resultados del código generado dinámicamente 


-IPI 


EJt* 









33 


Subprocesamiento 

en C# 


La potencia del multiprocesamiento de .NET Framework permite escribir apli¬ 
caciones muy estables con varios subprocesos en cualquier lenguaje NET. En 
este capitulo aprenderá los entresijos de los multiprocesos. El capítulo comienza 
con una visión general de los diferentes tipos de subprocesos y de su funciona¬ 
miento en NET Framework. para luego continuar enseñándole lo que puede hacer 
en sus aplicaciones gracias al multiprocesamiento. A medida que avance en el 
capitulo, sopese cuidadosamente los peligros de agregar varios subprocesos a sus 
aplicaciones antes de implementarlos. porque el multiprocesamiento no es un con¬ 
cepto sencillo. 

Subprocesamiento 


Antes empezar a escribir aplicaciones con múltiples subprocesos. debe com¬ 
prender lo que sucede cuando se crean los subprocesos y cómo gestiona el sistema 
operativo los subprocesos. 

Cuando se ejecuta una aplicación, se crea un subproceso primario y el ámbito 
de la aplicación se basa en ese subproceso. Una aplicación puede crear subprocesos 
adicionales para realizar tareas adicionales. Un ejemplo de creación de subprocesos 
primarios sería iniciar Microsoft Word. La ejecución de la aplicación comienza 


705 



en el subproceso principal. En la aplicación Word, la impresión en segundo plano 
de un documento sería un ejemplo de un subproceso adicional creado para contro¬ 
lar otra tarca. Mientras esta interactuando con el subproceso principal (el docu¬ 
mento Word), el sistema lleva a cabo su petición de impresión. Cuando el 
subproceso de la aplicación principal termina, todos los otros subprocesos crea¬ 
dos a partir de ese proceso también finalizan. Considere estas dos definiciones del 
Kit de desarrollo de software de Microsoft Foundation Class (MFCSDK): 

• Proceso. Una instancia que se ejecuta de una aplicación 

• Subproceso: Una ruta de ejecución dentro de un proceso 

C++ v MFC llevan muchos años apoyando el desarrollo de aplicaciones 
multiproceso. Como el corazón del sistema operativo Windows está escrito con 
estas herramientas, es importante que sean compatibles con la capacidad de crear 
subprocesos en los que se puedan asignar y crear tareas. En los primeros tiempos 
de Windows 3.1. la multitarea no existía; este concepto se hizo realidad con 
Windows NT 3.5 y NT 4.0 y luego en Windows 95. 98. 98SE. ME. 2000 y XP. 
Para aprovechar las características del sistema operativo, las aplicaciones con 
varios subprocesos se hicieron más importantes. Hoy en día. la capacidad de 
realizar más de una tarea a la vez es un rasgo necesario para una aplicación. 
Visual Basic 6.0 y versiones anteriores compilaban aplicaciones de un solo pro¬ 
ceso. lo que significaba que. sin importar lo que pasara, la aplicación de VB solo 
podía hacer una cosa a la v ez. 

En realidad, en un sistema con un solo procesador, no importa qué herramienta 
use para escribir su aplicación ya que todo sigue sucediendo en un proceso lineal. 
Si es un programador de C++. puede crear nuevos subprocesos y realizar tareas 
mientras tienen lugar otros sucesos, pero en realidad sólo se comparte el mismo 
tiempo con el resto de procesos que se están ejecutando en el sistema. Si solo hay 
un procesador, solo puede suceder una cosa cada vez. Este concepto se llama 
mullí (arca prete re n fe. 

Multitarea preferente 

La multitarea preferente divide el tiempo del procesador entre las tareas o 
subprocesos en ejecución. Cuando una tarea se está ejecutando, usa un espacio ele 
tiempo. Cuando el espacio de tiempo de la tarea que se está ejecutando caduca, en 
aproximadamente 20 milisegundos. dependiendo del sistema operativo que este 
usando, se invalida y otra tarea recibe el espacio de tiempo. El sistema guarda el 
contexto actual de la tarea invalidada y cuando se asigna a la tarea otro espacio 
de tiempo, se restaura su contexto y el proceso continúa. Este bucle de tarea 
continúa repetidamente hasta que la tarea es abortada o finaliza. La multitarea 
preferente da al usuario la impresión de que se realiza más de una tarea a la vez. 
¿Por que finalizan algunas tareas antes que otras, aunque se inicie antes la última 
en terminar? 
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Prioridades de subproceso y bloqueo 

Cuando se crean subprocesos, el programador o el sistema operativo les asig¬ 
na una prioridad Si una aplicación parece estar bloqueando el sistema, tiene la 
prioridad más alta y está bloqueando el acceso a los tiempos de los demás 
subprocesos. Las prioridades determinan lo que sucede y en qué orden Su aplica¬ 
ción puede estar completa en un 90 por ciento con un proceso determinado cuan¬ 
do. de repente, se inicia un nuevo subproceso y se coloca por delante del subproceso 
que esta ejecutando su aplicación, haciendo que a ese subproceso se le asigne una 
prioridad menor. Esto suele suceder en Windows. Algunas tareas son más priori¬ 
tarias que otras. Tomemos como ejemplo el nuevo Reproductor de Windows Me¬ 
dia. Al iniciar este proceso hace, básicamente, todo lo que se esta ejecutando deja 
de responder hasta que esta completamente cargado, incluyendo la pagina de la 
Guia multimedia. 

Uno de los mayores peligros a los que se enfrentan los programadores al escri¬ 
bir aplicaciones que usan varios subprocesos son las situaciones de bloqueo, en 
las que dos o más subprocesos intentan usar el mismo recurso. Un bloqueo de 
subproceso tiene lugar cuando un subproceso accede a un recurso compartido y 
otro subproceso con la misma prioridad intenta acceder a dicho recurso. Si los 
dos subprocesos tienen la misma prioridad y no se ha codificado el bloqueo co¬ 
rrectamente. el sistema sucumbe lentamente porque no puede liberar ninguno de 
los subprocesos de alta prioridad que se están ejecutando. Esto puede suceder 
fácilmente en las aplicaciones con varios subprocesos. Cuando el programador 
asigna prioridades a los subprocesos y están compartiendo datos globales, debe 
bloquear el contexto correctamente para que el sistema operativo gestione correc¬ 
tamente el espacio de tiempo. 

Multiprocesamiento simétrico 

En un sistema mnlf ¡procesador . puede tener lugar realmente mas de una tarea 
a la vez. Como cada procesador puede asignar espacios de tiempo a las tareas que 
quieren ejecutarse, puede realizar más de una tarea a la vez. C uando necesita 
ejecutar un subproceso largo que requiera mucho trabajo del procesador, como 
ordenar 10 millones de registros por nombre, dirección, codigo postal, apellidos y 
país, si se usan varios procesadores el trabajo concluirá antes que si se usa un 
solo procesador. Si puede delegar ese trabajo en otro procesador, la aplicación 
actualmente en curso no se verá afectada en absoluto. Tener más de un procesador 
permite este tipo de multiprocesamiento simétrico (SMP) La figura 33.1 mues¬ 
tra las opciones de procesador para SQL Server 2000. 

Si esta ejecutando SQL Server en un equipo multiprocesador. puede definir el 
numero de procesadores que debe usar para las tareas largas y que exigen el tipo 
mencionado. SQL lleva esto un poco más alia, realizando consultas a lo largo de 
los diferentes procesadores, uniendo los datos cuando se completa el ultimo 
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subproceso y mostrando los datos al usuario. Esto se conoce como sincronización 
de suhprocesos. El subproccso principal, que crea varios subprocesos, debe espe¬ 
rar a que todos los otros subprocesos estén completos antes de continuar con el 
procesado. 


Propiedades de SQL Server (C 


Conexiones ¡ 

Configuración de base de dafos 
General I Memoria 


Configuración del servidor j 

Duplicación | Active Directory | 
Procesador I Seguridad j 


Control del procesador 

•. Especifique qué procesadores utilizará SQL Server en un 
"sé entorno de multipfoceso simétrico (SMP). 


Procesador 


Número máximo de subprocesos de trabajo fj 


J 

~D 


P Aumentar la prioridad de SQL Server en Windows 
P Utilizar intraprocesos de Windows NT. 

Paralelismo 

"'■j Especifique el número de procesadores que desea utilizar para 
eiecutar consultas en paralelo 

Utilizar todos los procesadores disponibles 


r 




Umbral mínimo de plan de consultas para 
considerar la ejecución de consultas en paralelo 
(costo estimado): 


(• Valores configurados 


P Valores actuales 


Aceptar 


Ayuda 


Figura 33.1. Cuadro de diálogo de opciones de SQL Server 2000 Processor 


Observe que. cuando se usa un sistema SMP. un solo subproceso sigue ejecu¬ 
tándose en un solo procesador La aplicación VB6 se ejecuta exactamente igual 
que si le añade otro procesador adicional. Su aplicación de Access 2.0 de 16 bits 
tampoco se ejecuta mejor porque 16 bits siguen siendo igual a un solo proceso. 
Deberá crear nuevos procesos en los demás procesadores para aprovecharlos. 
Esto significa que no diseñamos una GUI multiprocesador. Desarrolle una GUI 
que cree otros procesos y pueda reaccionar cuando esos procesos se completen o 
sean interrumpidos, mientras sigue permitiendo al usuario usar la GUI para otras 
tareas. 


Cómo usar los recursos: cuantos más, mejor 

Los subprocesos consumen recursos. Cuando se están usando demasiados re¬ 
cursos. el equipo se ralentiza increíblemente. Si intenta abrir 80 instancias de 
Visual Studio NET mientras instala Exchange 2000 en un equipo con 96MB de 
RAM. percibirá que la pantalla no dibuja correctamente, el ratón no se mueve 
muy deprisa y la música que estaba escuchando en el reproductor de Windows 
Media ya no suena. Estos problemas de rendimiento se producen porque hay 
demasiados subprocesos ejecutándose al mismo tiempo en un sistema operativo 
con un hardware que no puede gestionar esta cantidad de trabajo. Si intenta hacer 
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lo mismo en un servidor nuevo, el Unisys de 32 procesadores con 1 terabyte de 
RAM, no percibirá ninguna pérdida de rendimiento. Cuanta más memoria tenga, 
más espacio físico tendrán las aplicaciones para crear más subprocesos. Cuando 
escriba aplicaciones que creen subprocesos, asegúrese de que tiene esto en cuen¬ 
ta. Cuantos más subprocesos cree, más recursos consumirá su aplicación. Esto 
podría llegar a causar un rendimiento menor que el de una aplicación de un solo 
proceso; todo depende del SO. "Cuantos más mejor" no se refiere a los subprocesos. 
Por tanto, tenga cuidado al crear subprocesos en la nueva versión de Tetris con 
múltiples subprocesos que está escribiendo en C#. 

Dominios de aplicación 

Anteriormente se indicó que el MFC SDK define un proceso como una instan¬ 
cia de una aplicación que se ejecuta. Cada aplicación que se esta ejecutando crea 
un nuevo subproceso principal, que dura lo que la instancia de la aplicación. 
Como cada aplicación es un proceso, cada instancia de una aplicación debe tener 
aislamiento de procesos. Dos instancias de Microsoft Word actúan independien¬ 
temente entre sí. Cuando hace clic en Ortografía y gramática, la InstanciaA de 
Word no comprueba los errores ortográficos del documento que se está ejecutan¬ 
do en la InstanciaB de Word. Incluso si la InstanciaA de Word intenta pasar un 
puntero de memoria a la InstanciaB de Word, la InstanciaB no sabra que hacer 
con él. o siquiera dónde buscarlo, ya que los punteros de memoria sólo se refieren 
a los procesos en los que se ejecutan. 

En NET Framework. los dominios de aplicación se usan para proporcionar 
seguridad y aislamiento de aplicación para el código gestionado. Algunos domi¬ 
nios de aplicación pueden ejecutarse en un solo proceso o subproceso, con la 
misma protección que si las aplicaciones se estuviesen ejecutando en varios pro¬ 
cesos. El consumo de recursos se reduce con este concepto, ya que las llamadas 
no necesitan estar circunscritas a los límites de los procesos si las aplieaciones 
necesitan compartir datos. Por el contrario, un solo dominio de aplicación puede 
ejecutarse en varios subprocesos. 

Esto es posible gracias al modo en el que el CLR ejecuta el código. Una vez 
que el código está preparado para ser ejecutado, el compilador JIT ya le ha hecho 
pasar el proceso de verificación. Este proceso de verificación garantiza que el 
código no va a realizar acciones inválidas, como accesos a memoria imprevistos, 
que provoquen un fallo de página. 

Este concepto de código de tipo seguro garantiza que un código no va a violar 
ninguna regla después de que el verificador lo haya aprobado al pasar de código 
MSIL a PE. En las típicas aplicaciones Win32. no existían mecanismos de pro¬ 
tección que evitaran que un fragmento de codigo suplantase a otro, de modo que 
cada aplicación necesitaba aislamiento de proceso. En NET. como la seguridad 
de tipo está garantizada, resulta seguro ejecutar varias aplicaciones de varios 
proveedores en el mismo dominio de aplicación. 
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Ventajas de las aplicaciones de varios 
subprocesos 

Algunas aplicaciones pueden sacar partido del multiproccsamiento. 

• Aplicaciones con procesos largos. 

• Aplicaciones de sondeo y escucha. 

• Aplicaciones con boton Cancelar en la GUI. 

Las siguientes secciones muestran cada una de estas razones. 

Aplicaciones con procesos largos 

Las aplicaciones que requieren procesos largos en los que el usuario no tiene 
por qué interactuar se pueden beneficiar del multiprocesamiento porque los pro¬ 
cesos de ejecución duradera pueden ser creados en un subproceso trabajador que 
procese la información en segundo plano hasta que se notifica al proceso que 
llamó al subproceso que este ya ha terminado. Entre tanto, el usuario no esta 
obligado a permanecer inactivo, mirando el cursor de reloj de arena para pasar a 
la siguiente tarea. 

Aplicaciones de sondeo y escucha 

Las aplicaciones de sondeo y de escucha pueden beneficiarse del 
multiprocesamiento Imagine que tiene una aplicación que ha creado subprocesos 
que están escuchando o sondeando. Cuando sucede algo, un subproceso puede 
consumir ese evento concreto y los otros subprocesos pueden seguir sondeando o 
escuchando por si sucede un evento. Un ejemplo de esto es un servicio que escu¬ 
cha las peticiones de un puerto de red o una aplicación de sondeo que comprueba 
el estado de Microsoft Message Queue (MSMQ) por si hay mensajes. Un ejemplo 
de una aplicación de sondeo comercial es Microsoft Biztalk Serv er. Biztalk esta 
constantemente sondeando en busca de cosas como archivos en un directorio o 
archivos en un servidor SMTP. No puede lograr todo esto con un solo subproceso, 
de modo que v arios subprocesos sondean recursos diferentes. Microsoft Message 
Queue tiene una extensión para Windows 2000 y una función de Windows \P 
llamada Message Queue Triggers. Con MSMQ Triggers. puede establecer pro¬ 
piedades que hacen que un desencadenador desencadene un evento. Este es un 
servicio de multiprocesamiento que puede manejar miles de solicitudes simulta¬ 
neas. 

Botón Cancelar 

Cualquier aplicación que tenga un boton Cancelar en un formulario debe se¬ 
guir este proceso: 
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1. Abrir y mostrar el formulario modalmente. 

2. Iniciar el proceso que tiene lugar en el nuevo proceso. 

3. Esperar a que el subproceso termine. 

4. Cerrar el formulario. 

Al seguir estos pasos, el exento click del boton Cancelar tiene lugar si el 
usuario hace clic en el botón mientras otro subproceso se esta ejecutando Si el 
usuario hace clic en el botón Cancel, en realidad hace clic mientras el proceso 
está ejecutándose en un subproceso que no es el que controla el exento click. y 
el código debe entonces detener el proceso en el otro subproceso que se esta 
ejecutando. Este es un rasgo de la GUI que convierte una buena aplicación en una 
aplicación genial. 

Cómo crear aplicaciones multiproceso 

Es hora de empezar a crear aplicaciones multiproceso. El multiproceso se 
controla a través del espacio de nombres System. Threading. Los miembros 
que usará más a menudo de la clase Thread aparecen en la tabla 33.1 

Tabla 33.1 Miembros comunes de la clase Thread 


Miembro Descripción 


CurrentContext 

Obtiene el contexto actual donde se está ejecutan¬ 
do el subproceso 

CurrentThread 

Obtiene el subproceso actualmente en ejecución 

ResetAbort 

Restablece una petición de anulación 

Sleep 

Bloquea el subproceso actual durante el tiempo 
especificado 

ApartmentState 

Obtiene o establece el estado de apartamento de 
un subproceso 

IsAlive 

Obtiene un valor que indica si el subproceso ha 
comenzado y no ha finalizado 

IsBackground 

Obtiene o establece un valor que indica si un 
subproceso es o no un subproceso en segundo pla¬ 
no 

Ñame 

Obtiene o establece el nombre del subproceso 

Priority 

Obtiene o establece la prioridad del subproceso 

Threadstate 

Obtiene el estado del subproceso 






Miembro 


Descripción 


Abort 

Inicia ThreadAbor tExcept ion, que puede finali¬ 
zar el subproceso 

Interrupt 

Interrumpe un subproceso que se encuentra en es¬ 
tado de subproceso WaitSleepJoin 

Join 

Espera un subproceso 

Resume 

Reanuda un subproceso que ha sido suspendido 

Start 

Inicia la ejecución del subproceso 

Suspend 

Suspende el subproceso 


Cómo crear nuevos subprocesos 

La creación de una variable de tipo System . Threadi.ng . Thread permi¬ 
te crear un nuevo subproceso con el que empezar a trabajar Como el concepto de 
subproceso implica la ejecución independiente de otra tarea, el eonstructoi T bread 
necesita la dirección de un procedimiento que liara el trabajo del subproceso que 
esta creando, bl delegado ThreadStart es el único parámetro que necesita el 
constructor para empezar a usar el subproceso. 

Para probar este código, cree un nuevo proyecto con la plantilla Aplicación de 
consola. El codigo del listado 33.1 crea dos nuevos subprocesos y llama al meto- 
do Start de la clase Thread para hacer que se ejecute el subproceso 

Listado 33.1. Cómo crear nuevos subprocesos 


using System; 

using System.Th reading ; 

public class Threads 
{ 

public void Threaderi() 
{ 


public void Threader2 () 
{ 


public class ThreadTest 
{ 
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public static int Mam (Stnng [ J a rgs ) 

{ 

Threads testThreading = new Threads (| ; 

Thread ti = new 

Thread(new ThreadStart (t estThreadi na.Threado r 1 ) } ; 
t i .Start ( ) ; 

Thread 12 = new 

Thread(new ThreadStart (testThreading.Threade rS)| ; 
tC.Start ( ) ; 

Consolé . ReadLme ( ) ; 
return 0; 

} 

1 

Cuando crea una variable de tipo thread. el procedimiento que controla el 
subproceso debe existir para el delegado ThreadStart. En caso contrario, se 
produce un error y la aplicación no compila. 

La propiedad Ñame establece o recupera el nombre de un subproceso. Esto le 
permite usar un nombre con sentido en lugar de una dirección de código hash para 
hacer referencia a los subprocesos que se están ejecutando. Esto es útil cuando se 
usan las utilidades de depuración de Visual Studio NET En la barra de tareas de 
depurado hay una lista desplegable con los nombres de los subprocesos en ejecu¬ 
ción. Aunque no se puede "salir" del subproceso y saltar a otro subproceso con el 
depurador, es útil para saber en que subproceso ha ocurrido un error 

Una vez declaradas, nombradas e iniciadas las variables de los subprocesos, 
necesita hacer algo en los subprocesos creados. Los nombres de procedimientos 
que se han pasado al constructor de subprocesos eran Threader 1 y Threader2. 
Ahora puede agregar código a estos métodos y observar como actúan. El eodigo 
debería tener un aspecto como el del listado 33.2. 

Listado 33.2. Cómo recuperar información de los subprocesos en ejecución 

u s i n g S y s t e m; 

us mg System.Threadmg; 

public class Threads 

( 

public v oid Threader] () 

( 

Consolé JnteLme (" * * * Threader] Information A * A ' " ) ; 

Consolé.WriteLine 

("Ñame: " + Thread.CurrentThread.Ñame); 

Consolé.WriteLine 

(Thread.CurrentThread); 

Consolé.WriteLine 

("State: " + Thread.CurrentThread.Threadstate); 
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Consolé.WriteLine 

("Priority: " + Thread.CurrentThread. Priority) ; 

Consolé.WriteLine(" * * * End Threaderl Information ***"); 

} 

public void Threader2() 

{ 

Consolé .WnteLi ne (" * * * Threader2 Information ***"); 

Consolé .WnteLme 

("Ñame: " + Thread.CurrentThread.Ñame); 

Consolé.WriteLine 

(Thread.CurrentThread) ; 

Consolé.WriteLine 

("State: " + Thread.CurrentThread.ThreadState); 

Consolé.WriteLine 

("Priority: " + Thread.CurrentThread.Priority); 

Consolé.WriteLine ( " *** End Threader2 Information * * * " ) ; 


} 

public class ThreadTest 

í 


public static int Main(String[] args) 
{ 


Threads testThreading = new Threads () ; 

Thread ti - new 

Thread(new ThreadStart(testThreading.Threader1)); 
ti.Ñame - "Threaderl"; 
tl.Start () ; 

Thread t2 = new 

Thread(new ThreadStart(testThreading.Threader2)); 
t2.Ñame = "Threader2"; 

t2.Start(); 

Consolé. ReadLme ( ) ; 
returnO; 

} 

} 


Cuando ejecuta la aplicación, el resultado en su consola debería parecerse al 
mostrado en la figura 33.2. 

El resultado que muestra la figura 33.2 no es muy bonito. Si realiza otra 
llamada, estará trabajando con subprocesos. Sin establecer una propiedad o dos. 
el procedimiento Threader 1 nunca terminará antes de que empiece Threader2. 
Cuando se ejecute el siguiente código: 

tl.Start ( ) ; 


714 



Comenzará la ejecución del código de Threader 1 . Como es un subproceso, 
tiene apenas 20 nulisegundos de espacio de tiempo, en ese periodo de tiempo 
alcanzará la segunda línea de código de la función, devolverá el control al sistema 
operativo y ejecutará la siguiente linea de código: 

12 . s t a r t ( ) ; 

El procedimiento Threader2 se ejecuta entonces durante su espacio de tiempo 
y es sustituido por el subproceso ti. Este ir y venir de procesos continua hasta 
que los dos procedimientos puedan finalizar 


a 


Figura 33.2. Resultado de una aplicación de subprocesamiento 

Prioridad de los subprocesos 

Para que el procedimiento Threader ] finalice antes de que el procedimiento 
Threader! empiece, debe darle a la propiedad Prior i ty el valor de la enu¬ 
meración ThreadPr i o r i t y correcta, con el objeto de asegurarse de que el 
subproceso t i tenga prioridad sobre cualquier otro subproceso. Antes de la lla¬ 
mada al método 1 1 . Start. agregue el siguiente codigo: 

ti.Prionty - Th r e a el P r i o r i t y . H i g h e s t. ; 

Cuando establezca la prioridad al máximo, ti finalizará antes que 11 . Si 
ejecuta la aplicación de nuevo, el resultado deberá ser como el que muestra la 
figura 33.3. La enumeración ThreadPriority establece como se planifica un 
determinado subproceso en relación a los otros subprocesos en ejecución. 
ThreadPriority puede adoptar cualquiera de los siguientes valores: 
AhoveNormal. HclowNormal . Highesf. I.owesf o Normal. El algoritmo que deter¬ 
mina el orden de los subprocesos varía en función del sistema operativo en el que 
se ejecutan los subprocesos. Por defecto, cuando se crea un nuevo subproceso, se 
le concede la prioridad 2. que es Normal en la enumeración. 
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Figura 33.3. Resultado tras establecer la prioridad del subproceso 


Estado del subproceso 

Al crear un nuevo subproceso, llamamos al método Start ( ) . En ese momen¬ 
to. el sistema operativo asigna espacio de tiempo para la dirección del procedi¬ 
miento pasado al constructor de subprocesos. Aunque el subproceso puede durar 
mucho tiempo, sigue pasando por diferentes estados mientras los otros subprocesos 
están siendo procesados por el sistema operativo. Este estado puede resultarle útil 
en sus aplicaciones. Basándose en el estado del subproceso, puede determinar si 
alguna otra cosa necesita ser procesada. Aparte de Start. los estados de 
subproceso que usará más frecuentemente son Sleep y Abort. Al pasar un 
número de milisegundos al constructor Sleep. está indicando al subproceso que 
abandone el resto de su espacio de tiempo. Si llama al método Abort se detiene 
la ejecución del subproceso. El listado 33.3 muestra código que usa Sleep y 
Abort. 

Listado 33.3. Cómo usar el método Thread.Sleep 

using System; 

using System.Threading; 

public class Threads 
{ 

public void Threaderl() 

{ 

foi(int intX - 0; intX < 50;intX ++) 

{ 

i f (intX ==: 5 ) { 

Thread.Sleep (500) ; 

Consolé.WriteLine("Threadl Sleeping");} 


} 





public void Threader2() 

{ 

for(int intX = 0; intX < 50;intX + +) 


if(intX == 5){ 

Thread.Sleep ( 5 0 0) ; 

Consolé . Wr iteLine ( "Thread2 Sleepmg" ) ; } 



public class ThreadTest 

{ 


public static int Main(String[J args) 

{ 


Threads testThreading = new Threads(); 

Thread ti = new 

Thread(new Threadstart (testThreading.Threader 1 ) ) ; 
tl.Priority = ThreadPriority.Highest; 

1 1 . S t a r t ( ) ; 

Thread 12 = new 

Thread(new ThreadStart (testThreading.Threader2) ) ; 
t. 2 . S t a r t () ; 

Consolé . ReadLme ( ) ; 
return 0; 


Observe que se ha establecido la propiedad Priority del subproceso ti al 
máximo. Esto significa que. pase lo que pase, se ejecutará antes de que comience 
t2. Sin embargo, en el procedimiento Threader 1. tiene el siguiente bloque if: 

for (int intX - 0; intX < 50;mtX ++) 

{ 

if ( intX = = 5) { 

Thread.Sleep(500); 

Consolé .WnteLine ("Thread2 Sleepmg" ) ; } 

} 

Esto indica al subproceso ti que se bloquee durante 500 milisegundos. aban¬ 
donando su actual espacio de tiempo y permitiendo que el subproceso t2 comien¬ 
ce a ejecutarse. Cuando los dos subprocesos se han completado, se invoca al 
método Abort y los subprocesos son eliminados. 

Las llamadas al método Thread . Suspend bloquean un subproceso indefi¬ 
nidamente. hasta que otro subproceso lo active de nuevo. Si alguna vez ha obser¬ 
vado el contador del procesador en el Administrador de tareas llegar al 100 por 
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ciento cuando no está gastando memoria, puede entender lo que sucede cuando un 
subproceso se bloquea. Para que el subproceso vuelva a funcionar, debe llamar al 
método Resume desde otro subproceso para que pueda reanudarse. El siguiente 
codigo muestra los métodos Suspend y Resume: 

Thread.CurrentThread.Suspend; 

Consolé .WriteLme ("Threadl Suspended" ) ; 

Thread.CurrentThread.Resume; 

Console.WriteLine("Threadl Resumed"); 

Aquí debe tener mucha precaución: Suspender subprocesos puede acarrear 
resultados indeseados. Debe asegurarse de que otro subproceso reanude el 
subproceso. 

La figura 33.4 muestra lo descrito en el párrafo anterior. Observe en la figura 
que la ventana de la consola está en la línea de codigo TI Suspended. Este 
ejemplo refleja una prueba, de modo que no necesita el método Resume. Los 
resultados del Administrador de tareas indican el estado del sistema. 
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W Mostrar procesos de todos los usuarios 
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Procesos: 35 Uso de CPU: 100% Carga de transacciones: 2093441c 


Figura 33.4. Procesador forzado por un subproceso bloqueado 


ThreadState es una combinación bit a bit de la enumeración 
FlagsAt.tr ibute. En cualquier momento, un subproceso puede estar en mas 
de un estado. Por ejemplo, si un subproceso es un subproceso en segundo plano y 
se está ejecutando en ese momento, el estado puede ser Running y Back- 
ground. La tabla 33.2 describe los posibles estados en los que se puede encon¬ 
trar un subproceso. 
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Tabla 33.2. Miembros de ThreadState 


Miembro 

Descripción 

Aborted 

El subproceso se ha anulado. 

AbortRequested 

Se ha solicitado la anulación del subproceso. 

Background 

El subproceso está ejecutándose como subproceso 
en segundo plano. 

Running 

El subproceso está ejecutándose. 

Suspended 

El subproceso se ha suspendido. 

SuspendRequested 

Se ha solicitado que el subproceso se suspenda. 

Unstarted 

El subproceso no se ha iniciado. 

WatSleepJoin 

El subproceso se ha bloqueado como resultado de 
una llamada a Wait, sieep o Join. 


Cómo unir subprocesos 

El método Thread . Jo i n espera a que el subproceso termine antes de seguir 
el proceso. Esto es útil si crea varios subprocesos para que cumplan una determi¬ 
nada tarea, pero antes de que quiera que la aplicación en segundo plano continúe, 
debe asegurarse de que todos los subprocesos que creo han terminado. En el 
siguiente ejemplo, cambie: 

T2.Join(); 

por 

Consolé.Writeline{"Writing"); 

La segunda vez que ejecute el código, obtendrá dos conjuntos de resultados. 
El resultado Writing no aparece en la consola hasta que los dos subprocesos 
han terminado. 


Listado 33.4. Cómo unir subprocesos 


using System; 

using System.Threading; 

public class Threads 
{ 

public void Threaderl () 

{ 

for(int intX - 0; intX < 50;intX ++) 
{ 

if(intX == 5) 
í 
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Th r e a el. S 1 e e p (5 O O ) ; 

Consolé.WriteLine("Threadl Sleeping"); 


} 


} 


public v o i d Threader2í) 

{ 

f o r fin t i n t X - 0 ; i n t X < 5 0 ; i n t X + + ) 

t 

i f (i n t X = - b i 

{ 

T bread . Sleep f 5 0 0 ) ; 

Consolé .WriteLine ("Threadl .Sleeping" ) ; 



pub 1 i c r: 1 a s s Th r eaclTes t 

{ 


public static mt Main ÍStringl ] args) 

{ 


Threacis t es t Th r e a el i ng - new Threads () ; 

Th reací t 2 - new 

Th rea d í n ew ThreadStart (testThreading.Thf eacier 2 ) ) ; 
t 2 . S t. a r t ( ) ; 

Threaci t X = new 

Th r eac.l (new ThreadStart (testThreadmg .Threader 1 ) ' ; 
t 1 . P r i o r i t y • Th r eadPr i o r i t. y . H i ghes t ; 
t1 .Start ( ) ; 

/* Invoca a Join para que espere a que todos los 
subprocesos t e rminen A / 

t 2 . J o i n ( ) / 


Consolé.WriteLine("Writing"); 


C o n solé. PeadL in e ( ) ; 
r e t u r n ü ; 

} 

) 

Como puede ver. el establecimiento de v arias propiedades en los subprocesos 
simplifica mucho su control. Tenga en cuenta que tras suspender un subproceso, 
debe reactivarlo o su sistema consumirá recursos innecesariamente. 
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Cómo sincronizar subprocesos 

La sincronización de datos es un aspecto importantísimo en la utilización de 
subprocesos. Aunque no es una tarea compleja de programación, los datos corren 
el riesgo de estropearse si no los dirige correctamente. 

Cuando los subprocesos están ejecutándose, comparten tiempo con otros 
subprocesos en ejecución. Esto se aprecia perfectamente en el ejemplo que ejecu¬ 
tamos en este capítulo. Si tiene un método que se esta ejecutando en varios 
subprocesos, cada subproceso sólo tiene varios milisegundos del tiempo del 
procesador antes de que el sistema operativo sustituya el subproceso para darle 
tiempo a otro subproceso del mismo método. Si esta en medio de una instrucción 
matemática o de la concatenación de un nombre, es probable que el subproceso se 
detenga algunos milisegundos y otro subproceso en ejecución sobrescriba sus 
datos. Sin embargo, esto no es el fin del mundo porque varios métodos le permiten 
hacer que esto no suceda. Observe el siguiente código: 

\ 

i n t: Y ; 
i n t V ; 

f or ( i n t Z = U ; 7. < 7 Ü ; Z + + > I 

i o t: u r n Y V; } 


Es muy probable que durante el bucle, un subproceso en ejecución se detenga 
para permitir que otro subproceso use este método. Recuerde que esto solo ocurre 
si permite que haya múltiples subprocesos accediendo a este bloque de codigo. Al 
escribir aplicaciones con múltiples subprocesos, esto sucede muy a menudo, de 
modo que necesita saber como solucionar la situación. El siguiente codigo resuel¬ 
ve este problema: 

lock (this) { 
int Y ; 
i n t V; 

í o r lint Z • 0 ; Z < 20; Z + +) { 

return Y * V;} 

} 

La instrucción Lock es un modo de obligar a los subprocesos a unirse. Su 
implementación es un poco diferente a la del método Join. Con Lock.. evalua¬ 
mos una expresión que se ha pasado al bloque Lock. Cuando un subproceso 
llega al bloque Lock.. espera hasta que puede conseguir un bloqueo exclusivo de 
la expresión que se esta evaluando antes de intentar seguir con el proceso. Esto 
asegura que no se estropeen los datos compartidos al usar varios subprocesos. 

La clase Monitor permite la sincronización mediante los métodos 
Moni tor.Entcr. Monitor .TryEnter y Morí 11 o r . E:-: i t . Iras usar un 
bloqueo en una región de código, puede usar los métodos Monitor .Walt. 
Monitor . Fu 1 se y Monitor . Fu 1 se A i 1 para determinar si un subproceso 
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debe continuar con un bloqueo o si algunos métodos bloqueados anteriormente 
están ya disponibles. Walt levanta el bloqueo si éste se mantiene y espera a que 
se le notifique. Cuando se inv oca Wait. se rompe el bloqueo y vuelve para volver 
a cerrarlo. 

Sondeo y escucha 


FJ sondeo y la escucha son otras dos instancias que representan la utilidad del 
multiprocesamiento. Las bibliotecas de clases, como System. Net. Sockets. 
inclinen un rango completo de clases de multiproceso que pueden ayudarle a 
crear agentes de escucha TCP. agentes de escucha UDP y una gran cantidad de 
tareas de red que requieren multiproceso. Observe la clase TimerCallBack 
del espacio de nombres System. Threading. Esta clase es muy parecida a las 
otras que hemos estado usando hasta ahora, excepto que una de las partes del 
constructor es un temporizados lo que le permite realizar sondeos en busca de 
acciones cada ciertos intervalos. 

Puede conseguir el mismo resultado agregando un control temporizado!* al 
formulario, pero usando la clase TimerCallBack. el temporizador y la res¬ 
puesta al procedimiento son automáticos. 

El listado 33.5 usa una devolución de llamada temporizada para sondear un 
directorio en busca de archivos. Si se encuentra un archivo, es rápidamente borra¬ 
do. Sólo debe ejecutar este código en un directorio de prueba, porque elimina 
archivos. FJ siguiente código de ejemplo busca en el directorio C:\Poll. El 
constructor de la clase TimerCal IBack espera una dirección en la que se v a a 
ejecutar el subproceso; un tipo de datos objeto que representa el estado del 
temporizador; un tiempo de vencimiento, que representa el período de tiempo 
hasta el que se van a realizar sondeos; y un período, que es una variable en 
milisegundos que indica cuándo se produce el intervalo de sondeo. 

Listado 33.5. Cómo usar el delegado TimerCallBack 


using System; 

using System.10; 
using System.Threading; 

n a me space cSharpTimerCallBack 
{ 

class C1a s s1 

{ 

public static void Main() 

{ 

Consolé.WriteLine 

("Checking direcotry updates every 2 seconds.") ; 
Consolé.WriteLine 
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(" (Hit Enter to termínate the sampie) ") ; 

Timer timer m new 

Timer(new TimerCallback(CheckStatus) , nuil, 0, 2000} * 

Console.ReadLine () ; 
timer.Dispose () ; 

} 

static void CheckStatus(Obgect State) 

{ 

strmg [ ] str - Directory . Get Files ( " C : \\Pol 1’') ; 
if (str.Length>0) 

{ 

for(int i = 0; i < str.Length;i++) 

{ 

Consolé .WnteLme (str [ i ] ) ; 

File.Delete (str [i]) ; 


Consolé .WriteLme ("Directory Empty") ; 


Tras ejecutar este programa durante un tiempo y copiar periódicamente unos 
cuantos archivos en el directorio C : \Po i I . el resultado en la consola tendrá un 
aspecto parecido al de la figura 33.5. 




Checking direcotry updates every 2 seconds. 

<Hit Enter to termínate the sample> 
C:\Poll\Bones .txt 
C:\Poll\nccl701 .xml 
C:\Po1l\q3 009 72 _w2 k_s p3_x8 6_en.exe 
Directory Empty 
Directory Empty 
C:\Poll\Bones .txt 
Directory Empty 
Directory Empty 

C: \Po 1 l\q300972 _w2 k_s p3 _x8 6 _e n . e xe 

Directory Empty 

C:\Poll\nccl701 .xml 

Directory Empty 

Directory Empty 

Directory Empty 


-,□1 X| 


L zi 


Figura 33.5. Resultado del listado 33 2 


Resumen 

En este capítulo ha aprendido a implementar múltiples subprocesos en C# con 
el espacio de nombres System. Thread. 

La idea básica tras el multiprocesamiento es simple: al crear mas de un 
subproceso, puede realizar mas de una tarea a la vez. Tiene que probar antes el 
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numero de subprocesos que vaya a crear Demasiados subprocesos pueden causar 
problemas de recursos. Si no se crean suficientes subprocesos, puede que la apli¬ 
cación no trabaje con todo su potencial. 

Con el ejemplo que ha creado aquí, debería estar preparado para implementar 
subprocesos en sus propias aplicaciones. Simplemente evite tomar riesgos por¬ 
que. como sabe. las aplicaciones con varios subproccsos pueden generar varios en 
problemas. 

Como siempre, planifique su aplicación con antelación y decida si el uso del 
multiprocesamiento es una parte importante de este proceso de planificación 
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34 


Cómo 


trabajar 
con COM 


Como programador de Windows, probablemente haya creado muchos compo¬ 
nentes COM. bien como DLL solitarias o como DLL que se ejecutan en servicios 
COM+. Con la llegada de .NET. se preguntará si debe reescribir todo con este 
nuevo lenguaje. Las buenas noticias son que no tiene que reescribir ninguno de 
sus componentes. Microsoft ha sido suficientemente considerado como para pro¬ 
porcionarnos las herramientas necesarias para usar sus componentes existentes 
de NET. Además, estos componentes pueden invocarse de forma segura desde el 
Entorno común de ejecución. En este capítulo aprenderá lo sencillo que es modi¬ 
ficar el código existente y usarlo desde un cliente administrado por NET. El 
cliente puede ser cualquier cosa: una aplicación Web. otro componente NET o 
incluso una aplicación basada en servicios. No importa; la funcionalidad princi¬ 
pal funciona en todo tipo de aplicaciones. 

Aunque siempre tiene la opción de reescribir su código, no es necesario. Pro¬ 
bablemente querrá usar NET para todos sus programas, especialmente el desa¬ 
rrollo GUI. ya que es mucho más sencillo de usar que las versiones anteriores. Al 
mismo tiempo, no querrá reescribir toda la lógica empresarial básica de sus apli¬ 
caciones. Con NET. todo esto es posible; puede convertir sus aplicaciones a 
NET mientras sigue usando las miles de líneas de codigo existente que ya ha 
escrito en sus componentes. 
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Kn este capitulo, aprendera a usar sus componentes COM existentes desde un 
cliente NET usando las herramientas suministradas junto a NET y verá como 
todo sucede en segundo plano. 

Introducción al Contenedor al que se puede 
llamar en tiempo de ejecución 

El codigo NET puede acceder a codigo no administrado mediante un proxy 
llamado Contenedor al que se puede llamar en tiempo de ejecución o RCW El 
RCW permite a una aplicación NET ver el componente no administrado como si 
fuera un componente administrado. 

Para ello, organiza llamadas a métodos, exentos y propiedades mediante un 
contenedor creado por su aplicación o manualmente, usando herramientas (como 
el Importador de la biblioteca de tipos) que proporciona el Framework. Usando 
información de la biblioteca de tipos COM. el RCW controla la mtcroperabilidad 
entre codigo administrado y el no administrado, ('uando ejecuta su aplicación, no 
es consciente de si el código que se esta ejecutando es el de una DEL no adminis¬ 
trada o COM El usuario de los componentes no necesita tener ningún conoci¬ 
miento especial de como se escribió el código, en que lenguaje fue escrito o si es 
un componente .NET. 

Todas las características del entorno administrado, como la recogida de ele¬ 
mentos no utilizados y el control de excepciones, están disponibles para el cliente 
.NET como si estuviera usando codigo administrado. Esto hace que sea extrema¬ 
damente sencillo transportar módulos desde sus aplicaciones anteriores a NET 
hasta .NET. sin tener que realizar un gran trabajo o comprender perfectamente 
los entresijos de cualquier lenguaje NET que este usando: C#. J# o VB NET. o 
cualquier otro. 

Puede rehacer el codigo cliente y colocar la lógica de datos y la lógica empre¬ 
sarial en su sitio usando interoperabilidad COM. La figura 34.1 muestra la rela¬ 
ción entre COM DLL. el RCW y la aplicación administrada NET. 



Figura 34.1. Código administrado y no administrado conviviendo juntos sin problema 
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Cómo crear ensamblados .NET a partir 
de componentes COM 

Para usar sus componentes COM en una aplicación NET. debe crear el en¬ 
samblado de interoperabilidad. o RCW. que organiza las llamadas de método 
desde el cliente NET al servidor COM En .NET hay varios modos de realizar 
esto. Los dos modos mas comunes son los siguientes: 

• La utilidad Importador de la biblioteca de tipos, o Tlbimp.exe. proporcio¬ 
nada junto a NET Framework 

• Hacer referencia directamente al C OM desde la aplicación de C# VS NL I 

El proxy creado para la interoperabilidad se basa en los metadatos expuestos 
en la biblioteca de tipos del componente C OM al que se esta intentando acceder. 
Las bibliotecas de tipos COM pueden hacerse accesibles de una de estas dos 
formas: 

• Las bibliotecas de tipos pueden encontrarse como arclmos individuales. 
Las bibliotecas individuales de tipos suelen tener la extensión TLB. Las 
bibliotecas individuales de tipos mas antiguas pueden tener la extensión 
OLB. Si está creando una DLL ActiveX de Visual Basic, puede crear una 
biblioteca individual de tipos para su componente seleccionando la opción 
Archivos de servidor remoto en el cuadro de dialogo Propiedades del 
proyecto. 

• Las bibliotecas de tipo también pueden encontrarse incrustadas en un ser¬ 
vidor COM como un recurso binario. Los servidores COM en curso, em¬ 
paquetados como DLL y los servidores C'OM detenidos, empaquetados 
como EXE. pueden incluir la biblioteca de tipos como un recurso del pro¬ 
pio servidor COM. Los componentes COM creados con Visual Basic tie¬ 
nen la biblioteca de tipos compilada dentro de la DLL. 

En la siguiente sección aprenderá a crear el ensamblado de interoperabilidad a 
partir de una DLL C OM mediante los dos métodos descritos al principio de esta 
sección: usando la utilidad Tlbimp y haciendo referencia directamente al DLL 
desde Visual Studio NET. 

Cómo usar la utilidad Tlbimp 

La utilidad Tlbimp es una aplicación individual de consola que crea el ensam¬ 
blado de interoperabilidad NET basado en la DLL COM que especifique. Esta 
situada en el directorio Framework SDK en Archivos de programa. El siguiente 
fragmento de codigo muestra la sintaxis de Tlbimp: 

tlbimp [COMDl1Fi1ename 1 / [options] 
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La tabla 34.1 .recoge las opciones de línea de comandos para tlbimp.exe 
Tabla 34.1. Tlbimp.exe Opciones 


Opción Descripción 


/asmversion:versionumber Especifica el número de versión del ensam¬ 
blado que se genera 

/delaysign Especifica a Tlbimp.exe que firme el ensam¬ 

blado resultante con firma postergada 

/help Muestra las opciones de ayuda para tlbimp. 

exe 

/keycontainercontainername Firma el ensamblado resultante con un nom¬ 
bre seguro utilizando el par de claves pública 
y privada que se encuentra en el contenedor 
de claves especificado en el parámetro nom¬ 
bre del contenedor 

Suprime la presentación de la portada de ini¬ 
cio de Microsoft 

Especifica el nombre del archivo resultante 
que se creará. Por defecto, el archivo resul¬ 
tante tiene el mismo nombre que la DLL COM, 
pero tenga cuidado si intenta sobrescribir el 
archivo en caso de que exista en la misma 
ruta 

Genera un ensamblado de interoperabilidad 
primario para la biblioteca de tipos 

Especifica el archivo que contiene la clave 
pública que se debe usar para señalar el en¬ 
samblado resultante 

Especifica el archivo de ensamblado que se 
utiliza para resolver referencias en tipos defi¬ 
nidos fuera de la biblioteca de tipos actual 

Suprime la presentación de mensajes de apro¬ 
bación 

/strictref No importa una biblioteca de tipos si la herra¬ 

mienta no resuelve todas las referencias in¬ 
cluidas en el ensamblado actual o en los 
ensamblados especificados con la opción / 

re ference 

/sysarray Importa cualquier SafeArray de estilo COM 

como un tipo Clase System.Array adminis¬ 
trado 




/nologo 

/oubfilename 

/primary 

/publickey:filename 

/reference:filename 

/silent 




Opción 

Descripción 

/unsafe 

Genera interfaces sin comprobaciones de segu¬ 
ridad de NET Framework. Esta opción no se debe 
utilizar a no ser que se conozcan los riesgos que 
supone exponer este código como no seguro 

/verbose 

Muestra información adicional sobre la bibliote¬ 
ca de tipos importada cuando se ejecuta 
tlbimp.exe 

/? 

Muestra ayuda sobre la sintaxis para tlbimp. exe 


Este comando produce un ensamblado NLT con una extensión DLL que reci¬ 
be el mismo nombre base que la biblioteca incrustada en el archivo de la bibliote¬ 
ca de tipos (que puede ser diferente del nombre de archivo de la propia biblioteca 
de archivos). El comando tlbimp admite el nombre de un archivo de biblioteca de 
tipos como dato introducido: 

t1bimp s e r ve i . 11b 

También puede admitir el nombre de un senador ( OM que contiene la biblio¬ 
teca de tipos incrustada: 

t. 1 b i mp server . d 11 

Al usar la opción /out. se puede especificar un nombre alternativo para el 
ensamblado NLT creado: 

t 1 b i mp server . di .1 /out : clot N e t S e r v e r .di 1 

L1 ensamblado producido por la herramienta Tlbimp.exe es un ensamblado 
NLT estándar que puede ser visto con I ldasm.exe. Ll ensamblado no contiene el 
código del servidor COM; en su lugar, contiene referencias que ayudan al C LR a 
encontrar los objetos COM almacenados en el servidor, como los GU1D del obje¬ 
to COM Imagine el ensamblado generado por tlbimp como un puente que conecta 
el código NLT con el servidor COM. Como el código COM sigue estando en el 
servidor COM. no debe olvidar instalar e inscribir en el registro todos los servido¬ 
res COM que piense usar en sus aplicaciones .NLT. En realidad, esto supone una 
gran ventaja para el programador. Como el servidor C OM sigue registrado con 
Windows, las aplicaciones C’OM estándar que no son conscientes de la existencia 
de .NET pueden seguir usando el mismo servidor C OM sin trasladar código a una 
plataforma específica .NET. 

Cómo crear un componente COM 

Antes de emplear la utilidad Tlbimp necesita un componente COM con el que 
trabajar. Ll listado 34.1 muestra el código para un sencillo DLL ActiveX VB6 
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con varias funciones de clase común, como establecer y recuperar una propiedad, 
desencadenar un evento y devolver un valor de un método que tenga parámetros 
de entrada. 

Listado 34.1. Código de servidor COM para Visual Basic 6.0 


Op tion E x plicit 

Prívate strMessage As Stnng 

Public Event COMEvent(Message As Stnng) 

Privat e S ub Cldss_Tn.i tial i z e ( ) 
s t_ r Message - " Default Message" 

End Sub 

Pub1ic P r opert y Get Message¡) As S t ring 
e s s a g e - s t r M e s s a g e 
End Property 

Public Property Let Message (ByVal vNewValue As Stnng) 
t rMe s s a ge - vNewVa 1ue 
End Property 

Public Fuñet i qn Squarelt (mtl As Integer, int2 As Tnteger) As 
1 n t. e g e r 

guare! t - inti * mt;2 
End Function 

P 11 b1 io S ub F i reC OM Event ( ) 

a i seEvent COMEvent (strMessage) 

En tí Sub 

Este codigo se coloca en un modulo de clase llamado COMObj ect. El módulo 
de clase esta en un proyecto llamado VBGCOMServer. Visual Basic 6.0 compila 
este codigo en un servidor COM en proceso e incrusta una biblioteca de tipo en el 
servidor. La representación legible de la biblioteca de tipos, escrita en Lenguaje 
de definición de interfaz (IDE) de C OM se muestra en el listado 34.2. 

Listado 34.2. Fuente IDL para el servidor COM del listado 34 1 

// Archivo .101. generado (por el Visor de objetos OLE/COM) 

// 

// typelib fi leñame: VBcCOMServer.dll 
r 

uuidfPM U91C 5 0 -ACA4 - 4 E i F- 8 D 3 t - F 3 6 F 1 EE5 FO 3 B) , 
v e r s i o n f 1 . 0 ) 

] 

library VRíCOMServer 

{ 

// TLib : // TLib : OLE Automation : { 00020430- 000ü- 0000 - 
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C O 0 O - Ü O O O O 0 O O O O 4 6 } 

imp ortlib("stdole2.tlb") ; 

// Declaración anticipada de todos los tipos definidos en 
// esta biblioteca de clases 
interface COMObject; 
dispinterface _COMObject; 


[ 

odl, 

uuid{5 960D7 80-FEA2-4 383-B2CB-5F78E4677 142) , 
version (1.0) , 
hidden , 
dual, 

nonext ensible, 
oleautomation 

] 

interface _COMObject : IDispatch { 

[id(Ox68030000), propget] 

HRESULT Message { [out, retval] BSTR* ); 

[id(0x6803 0000) , propput] 

HRESULT Message ([m] BSTR ); 

[id (0x60030002) ] 

HRESULT Squarelt ( 

[m, out] short* intl, 

[m, out] short* mt2, 

[out, retval] short* ); 

[id (0x6 00 30003) ] 

HRESULT F i r e COME ven t. () ; 


uuid(5 0 7 3 0 C9 7-0 9 EB-i 9 5 C - 98 7 3 BEC639 9AA6 3 A) , 
versión (i.0) 

] 

cocíass COMObject { 

[default] interface _COMObject; 

[default, source] di spinterf ace COMO-bjecL; 


[ 

uuid(A4D4C3D8-DFFF-45DB-9A14-791E4FS2EF35), 
version ( 1.0) , 
hidden, 
nonextensible 

] 

dispinterface COMObject { 

properti es: 
methods: 

[id(0x00000001) ] 

void COMEvent([in, out] BSTR* Message); 
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Para crear el ensamblado de interoperabilidad que permite a la aplicación C# 
usar la DLL no administrada, debe ejecutar la utilidad Tlbimp descrita en la 
anterior sección. En la figura 34.2. puede ver que el parámetro /out: se usa 
para dar al ensamblado de interoperabilidad el nombre compinterop . di 1 . El 
nombre del ensamblado resultante puede ser el que prefiera (incluso puede tener 
el mismo nombre que el componente COM original). 




Figura 34.2. La utilidad Tlbimp en funcionamiento 

El VB6COMSer\er.dll que se creo usando VB6 ahora puede ser consumido 
desde cualquier cliente NET (siempre que la aplicación haga referencia al en¬ 
samblado comí nterop . d 1 1 y el componente VB6 este registrado en el equipo 
que este intentando consumir el eodigo). Cóomo el resultado de Tlbimp es ahora 
un ensamblado .NET. puede usar la utilidad ILDASM para ver los detalles sobre 
el metadato que se creó a partir de la DLL ActiveX que usa realmente el CLR La 
figura 34.3 muestra la utilidad ILDSM cuando se ejecuta el nuevo cominterop . 
d ] 1 recién creado. 

El ensamblado generado al importar la biblioteca de tipos cuyo código fuente 
se muestra en el listado 34.3 incluye un espacio de nombres llamado cominterop. 
que es el nombre del ensamblado que se paso al parámetro /out desde la utilidad 
Tlbimp. Este espacio de nombres debe ser tratado exactamente igual que un espa¬ 
cio de nombres definido por el codigo o por NET Framework: el codigo debe 
hacer referencia al espacio de nombres cuando use alguna de las clases del espa¬ 
cio de nombres. 

La figura 34.3 muestra las clases insertadas en el ensamblado generado por 
tlbimp La clase que usamos en el codigo C# para trabajar con el objeto COM 
tiene el mismo nombre que el objeto COM en la instrucción coclass de la 
fuente 1DL. En el listado 34.3. el objeto COM recibe un nombre coclass de 
COMObject El ensamblado generado por tlbimp incluye una clase .NET con el 
mismo nombre y es esta clase la que se usa en el codigo para trabajar con el objeto 
Visual Basic COM 


c\ S ímbolo del sistema Visual Studra .NET 


^jnj 


C:\>tlbimp c:\ub6comserver.dll /outicominterop.dll 

Microsoft <R> .NET Framework Type Library to Ássembly Conoerter 1.0.370 
Copyright <C> Microsoft Corporation 1998-2001. fill rights reseroed. 

Type library imported to C:\coninterop.dll 


► 
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Figura 34.3. ILDASM con un ensamblado generado por Tlbimp 


Cómo usar el ensamblado de interoperabilidad desde C# 

Usar el componente COM desde C# es muy sencillo una vez que ha creado el 
ensamblado de interoperabilidad. Para usar este ensamblado, siga los siguientes 

pasos: 


1. Cree una aplicación de cliente de prueba. Para hacerlo mas sencillo, cree 
una nueva aplicación de formulario de Windows y llámela Interop. 

2. Una vez que ha creado la aplicación, coloque su código en el ev ento ciick 
de un botón y agregue un botón a Forml . es. A continuación, haga clic 
con el botón derecho del ratón sobre el archivo Referenees en el Ex¬ 
plorador de soluciones y seleccione Agregar referencia. Se abrirá el 
cuadro de diálogo Agregar referencia. Es igual al cuadro de dialogo 
Agregar referencia de VB6. Básicamente, debe hacer referencia al en¬ 
samblado que necesita usar, que al igual que cualquier otro ensamblado 
NET no se añade por defecto a un nuev o prov ecto. 

3. Para agregar una referencia a la DLL Cominterop que creo anteriormente, 
haga clic en el botón Examinar y localice el ensamblado en su disco duro. 
Una vez hecho, su cuadro de diálogo Agregar referencia deberá 
tener un aspecto similar al de la figura 34.4. 
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EJES 


XI 


NET j COM | Proyectos | 



Nombre de componente _ 

Accessibilitv.dll 

Versión 

| Ruta de acceso I *** 



1.0.3300.0 

C: \ WINDO WS\Microsoft, NET\... 



.idodh 

7 n 3 ÜOM.U: 

'I :\Ar chiivoL 

de progr ama'iMic. . — 
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de programa'iArr. .. 
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de programa'iArr 
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de progr ama'iArc. .. 



•.'Jrystalt nterpriseLib 

l .0.0 IJ 

C:\ Archiven 

de progr ama'iArc, . 



'.rystalIntoStoreLib 

1.0.0.0 

'I:\Archivrn 

de progr amar, Are,.. 



Oy-.tall eylúdeLib 
i'r'-’-.tMPhirunMnrl ih 

1.0.0.0 

■ I: 'i, Archivo*: 

r :'i Arrhivfp* 

de programa\Are.., . 

de nrnnrarna'iArr. — 1 

Componentes seleccionados: 

Nombre de componente 

Tipo 

| Origen 




cominterop.dll 


C:\cominterop.dll 


Aceptar j Cancelar j Ayuda j 


Figura 34.4. Adición de la referencia Cominterop 


Una vez que la aplicación hace referencia al ensamblado, puede usarlo exacta¬ 
mente igual que cualquier otro ensamblado .NET. Como Visual Studio NET 
dispone de funciones tan útiles (como completar o listar miembros automática¬ 
mente) una vez que se agrega la referencia, sus métodos, ex entos y propiedades 
están a su disposición mediante el IDE. La figura 34.5 muestra el listado automá¬ 
tico de miembros en funcionamiento después de que la instancia del objeto 
Cominterop hava sido creada y de que se haga referencia al ensamblado con la 
instrucción us ing. 


pnvate y o id button1_Clickiobject sender. System. EventArgs e) 

{ 


COMObject Objectlnstance: 
short Numl 
short Num2 
short Sum; 

Objectlnstance = new COMObjectClassí); 

Numl = 123 
Num2 = 456 
Sum = Objectlnstance 

* ; 

♦ •-.-■"'F.- r 

♦ .: : .le 

♦ pe 
EÍ? '-'e ge 


¡Squarelt 


_I _I 

Figura 34.5. Listado automático de miembros en funcionamiento 
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Para comprobar todos los métodos, propiedades y eventos que ha escrito en la 
DLL ActiveX, copie el listado 34.3 en la aplicación WindowsForms. 

Listado 34.3. Código de cliente COM escrito en C# 

/// <sumary> 

/// El principal punto de entrada para la aplicación. 

/ / / < / s urna r y > 

[ STAl'hr ead] 
static void Main(} 

{ 

Application.Run(new Forml()); 

} 

// Cree un controlador para el evento 

privat e COMObj ect_COMEventEventHandler 

COMEventHandlerInstance; 

prívate void buttonl Click(object sender, System.EventArgs e) 

{ 

// cree una nueva instancia de la clase COMObject 

COMObgect Ob jectInstance ; 

short Numl; 

short. Num2 ; 

short Surtí; 

ObjectInstance - new COMObjectClass(); 

Numl = 5; 

Num2 - 6; 

// Llame al método Squarelt 

Sum - Ob]ectInstance.Squarelt(ref Numl, ref Num2); 

ÜstBoxl . Items . Add (Sum. ToStrmg ( ) ) ; 

1istBoxl.Items.Add (ObjectInstance.Message); 

// Establezca un valor de mensa]e diferente del que se 
// ofrece por defecto 

ObjectInstance.Message - "C# Rocks"; 

COMEventHandlerInstance = new 
__COMObject_COMEventEventHandler (COMEventHandler) ; 

ObjectInstance.COMEvent +- COMEventHandlerInstance; 

Ob]ectInstance.FireCOMEvent () ; 


void COMEventHandler(ref string Message) 

{ 

ÜstBoxl . Items .Add (Message) ; 

} 
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Cali interop Assembly 


! Default MüSbaye 

\Cz Cocks 


Figura 34.6. Resultado del cliente C# usando el componente COM 

Como cualquier otro objeto de NET. el operador new se usa para crear una 
nuev a instancia de la clase COMObj cct. como muestra el siguiente fragmento de 
eodigo: 

0Lyrct I n.s t. ance - new COMOb j ect { ) t 

I ras instanciar el nombre de la variable Ob'jectinstance. use el objeto 
igual que cualquier otro objeto NET: no hace falta hacer nada especial El RCW 
se encarga de toda la interoperabilidad. conversiones de tipos y organización de 
objetos para los tipos, de modo que no se dará cuenta de ninguno de los prepara- 
ticos internos COM que se están produciendo. 

Si ha usado la interoperabilidad COM de VB.NET. percibirá algunas diferen¬ 
cias respecto al modo en que se pasan los parámetros a los métodos en CU. Si 
observa el código de CU del método Squarelt. verá que se ha agregado la 
palabra clave Reí 

IJuml • j ; 

MtTfrn = •: ; 

fij T, 1 d m;o a 1 me t. od o S q.'U d r e 11 

yum = Ob ;ect I n.s Unce . Sanar e It ! re f Numl, ref Num2 } ; 

Los servidores COM de Visual Basic pueden pasar valores por calor o por 
referencia. El eodigo CU necesita usar las palabras clave adecuadas cuando pasa 
parámetros a las llamadas de método COM Puede usar ILDASM para que le 
acude a determinar si un parametro debe pasarse por calor o por referencia. 

Abra el ensamblado generado por Tlbimp usando la herramienta ILDASM c 
mire la definición del método al que quiere llamar. En este caso, debe llamar al 
método Squarelt ( : . que se muestra en el ensamblado con la siguiente firma: 

S qua r e 2 t. : i n t i r i i n t 1 i* , i n 11 r & ) 

Tras los dos puntos situamos el tipo de calor devuelto por el método La firma 
del método Squarelt ( ) muestra un tipo devuelto intl6. que. en la jerga del 
lenguaje intermedio, indica un entero de 16 bits. Tras los tipos de parámetro se 
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coloca un signo & que indica que el parámetro debe pasarse por referencia. Los 
parámetros que deben ser pasados por referencia deben ir acompañados de la 
palabra clave ref en el cliente CU. Los parametros que deben pasarse por valor 
no aparecen con el símbolo & en el ensamblado. En este caso, el cliente CU no 
necesita usar la palabra clave ref en los parámetros. 

Cómo hacer referencia a la DLL COM desde C# 

En la sección suman, aprendió a usar el ensamblado de interoperabilidad 
creado por Tlbimp.exe en una aplicación de formulario Windows de CU. La prin¬ 
cipal razón para usar Tlbimp.exe para crear el ensamblado de interoperabilidades 
es que se le puede dar un nombre seguro con la utilidad SN.exc para después 
instalarlo en la cache de ensamblados global usando la utilidad GACUTIL Una 
vez en la Ga\C. el ensamblado puede ser compartido entre muchos otros ensam¬ 
blados o provectos NET. Si esta escribiendo una aplicación que usa 
interoperabilidad COM y el ensamblado no necesita ser compartido, puede sim¬ 
plemente hacer referencia a la DLL COM mediante Visual Studio .NET. lo que 
creara el RCW por nosotros. 

Para agregar una referencia para una DLL COM directamente a su provecto, 
siga estos pasos: 

1 Haga clic con el botón derecho del ratón en la carpeta References del 
Explorador de soluciones. Se abrirá el cuadro de dialogo Agregar re¬ 
ferencia. mostrado en la figura 34.7. La segunda ficha. COM. muestra 
todos los objetos COM registrados en el equipo local. 


I Agregar referencia ■ 


.NET COM | Proyectos | 

I Nombre "de co mponente ] Versión de ... j Ruta de acceso" 


•.'6 Datai* 1 '. '.•Vi^doY-.- 1 0 C piociar' 1 F les M’C'Os:**"* 



*J 




Examinar... 


seleccionar 


zl 


Nombre de componente 

_ 1 _l£2_ 

! Origen 


Quitar 

IVB6COMServer 

COM 

C:\VB6COMServer.dl 

mm 



Aceptar j cancelar j Ayuda j 


Figura 34.7. Cómo agregar una referencia a un objeto COM directamente 
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2. I ras seleccionar el componente COM que debe usar, puede utilizar el mis¬ 
mo código que usó para escribir la aplicación de formulario de Windows, 
cambiando solamente el ensamblado al que se hace referencia, que en este 
caso sera VBóComServer y no Cominterop. 

using VBcCOMServer; 

ObjectInstance = new COMOb j ectClass () ; 

Como puede ver. hacer referencia a un componente COM directamente desde 
IDE es incluso mas sencillo usando la utilidad Tlbimp. aunque pierda parte de 
versatilidad respecto a lo que puede hacer realmente con el componente. 

Cómo manejar errores de interoperabilidad 

En NET Framework. el CLR informa de los errores iniciando excepciones 
cuando algo sale mal. En COM. los HRESULT son el modo de informar de los 
errores, de modo que el RCW necesita ser capaz de describir el HRESULT de un 
error dado a la excepción NET equivalente. 

La tabla 34.2 describe los HRESULT estándar de COM a sus excepciones 
NET equivalentes. 


Tabla 34.2 HRESULT para excepciones NET 


HRESULT 


Excepción .NET 


MSEE E APPDOMAINUNLOADED 

COR_E_ APPLICATION 

COR E ARGUMENT o EINVALIDARG 

COREARGUMENTOUTOFRANGE 

COR E ARITHMETIC o ERROR_ARITHMETIC_OVERFLOW 
COR E ARRAYTYPEMISMATCH 

COR E BADIMAGEFORMAT o ERROR BAD FORMAT 

COR E COMEMULATE ERROR 

COR E CONTEXTMARSHAL 

COR_E CORE 

NTE FAIL 

COR E DIRECTORYNOTFOUND o ERROR PATH NOT FOUND 

COR E DIVIDEBYZERO 

COR E DUPLICATEWAITOBJECT 

COR E_ ENDOFSTREAM 

COR E TYPELOAD 

COR E EXCEPTION 


AppDomainUnloadedException 

ApplicationException 

ArgumentException 

ArgumentOutOfRangeException 

ArithmeticException 

ArrayTypeMismatchException 

BadlmageFormatException 

COME mulateExcept ion 

ContextMarshalException 

CoreException 

CryptographicException 

DirectoryNotFoundException 

DivideByZeroException 

Dupl icate WaitObjectExcept ion 

EndOfStreamException 

EntryPointNotFoundException 

Exception 
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HRESULT 


Excepción .NET 


COR E EXECUTIONENGINE 
COR E FIELDACCESS 

COR E FILENOTFOUND o ERROR FILE NOT FOUND 

COR E FORMAT 

COR EINDEXOUTOFRANGE 

COR E INVALIDCAST o E NOINTERFACE 

COREINVALIDCOMOBJECT 

COR EINVALIDFILTERC RITE RIA 

COR E INVALIDOLEVARIANTTYPE 

COR E INVALIDOPERATION 

COR E IO 

COR E MEMBERACCESS 

COR E METHODACCESS 

COR E MISSINGFIELD 

COR E MISSINGMANIFESTRESOURCE 

COREMISSINGMEMBER 

COREMISSINGMETHOD 

COREMULTICASTNOTSUPPORTED 

COR E NOTFINITENUMBER 

E NOTIMPL 

COR E NOTSUPPORTED 
COR E NULLREFERENCE o E POINTER 
COR E OUTOFMEMORYo E OUTOFMEMORY 
COR E OVERFLOW 

COR E PATHTOOLONG o ERROR FILENAME EXCED RANGE 
COR E RANK 

COR E REFLECTIONTYPELOAD 

COREREMOTING 

CORESAFEARRAYTYPEMISMATCH 

CORESECURITY 

COR E SERIALIZATION 

COR_E STACKOVERFLOW o ERROR STACK OVERFLOW 

COR E SYNCHRONIZATIONLOCK 

CORESYSTEM 

COR E_TARGET 

COR E TARGETINVOCATION 

COR E TARGETPARAMCOUNT 

COR E THREADABORTED 


ExecutionEngineException 

FieldAccessException 

FileNotFoundException 

ForríiatException 

IndexOutOfRangeException 

InvalidCastException 

InvalidComObjectException 

Inval id FilterCriteriaException 

InvalidOleVariantT ypeException 

InvalidOpefalionExceptioii 

lOException 

AccessExceplion 

MethodAccessException 

M¡ssingF¡eldExce|)t¡on 

MissingManifestResour ceException 

MissingMemberExceplion 

MissingMethodException 

MulticastNotSupportedException 

NotFiniteNumberException 

Noli mplementedExcept ion 

NotSupportedException 

NullReferenceExceplion 

OutOÍMemoryException 

OverflowException 

PathTooLongException 

RankException 

ReflectionTypeLoadException 

RemotingException 

SafeArrayTypeMismatchException 

SecurityException 

SerializationException 

StackOverflowException 

SynchronizationLockException 

SystemException 

T argetException 

TargeílnvocationException 

T argetParameterCountException 

ThreadAbortException 
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HRESULT 


Excepción .NET 


COR E THREADINTERRUPTED 

COR E THREADSTATE 

COR E_THREADSTOP 

COR E TYPELOAD 

COR_E_TYPEINITIALtZATION 

COR E VERIFICATION 

CORE WEAKREFERENCE 

COR E VTABLECALLSNOTSUPPORTED 

Cualquier otro HRESULT 


ThreadlnterruptedException 

ThreadStateException 

Th readStopException 

TypeLoadException 

TypelnitializationException 

VeriíicationExceptiou 

WeakReferenceException 

VTableCalIsNotSupportedException 

COMException 




Si su aplicación debe obtener información de error extendida y el objeto COM 
admite la interfaz lEr rorlnfo. puede usar el objeto IErrorlnfo para con¬ 
seguir información sobre la excepción. La tabla 34.3 describe la información de- 
error adicional. 


Tabla 34.3. Información de error extendida de interoperabilidad COM 


Campo de la excepción Información de la fuente COM 


ErrorCode El hresult devuelto por la llamada de método 

HelpLink Si iErrorinfo->HelpContext no es cero, 

la cadena se forma concatenando IErrorlnfo 
- > G e t H e 1 p F i 1 e y "#" y IErrorlnfo- 
>GetHe 1 pContext. En caso contrario, la ca¬ 
dena devuelta procede de IErrorlnfo-.- 
Get HelpFi le. 


InnerException 

Message 

Source 

StackTrace 

TargetSite 


Siempre es nuil 

Cadena devuelta de iF.rrorinfo->GetDes- 
cription 

Cadena devuelta de IErrorlnfo ->GetSour£é 

El seguimiento de la pila de esta excepción NET 

El nombre del método que hizo que se devol¬ 
viese HRESULT a .NET 


Obviamente, debe incluir control de errores en sus aplicaciones, aunque este 
usando interoperabilidad COM, No hay diferencia fundamental entre el modo de- 
codificar componentes C’OM y el modo de codificar ensamblados NET. de modo 
que el control de excepciones estructurado de NET debe usarse siempre que 
escribe código susceptible de causar una excepción. 
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Cómo usar la invocación de plataforma 


Si es un programador de Visual Basic (\ el API Win32 ha sido su modo de 
aprovechar toda la potencia de la programación. En NLT. todavía puede acceder 
al API Win32 desde C#. aunque casi toda o toda la funcionalidad que probable¬ 
mente este usando ya estaba presente en NET Framework. La invocación de 
funciones de DLL de C se consigue usando el servicio invocación de plataforma. 
La imocación de plataforma es un servicio que permite al codigo administrado 
llamar a funciones de DLL COM no administradas. 

Mediante la clase DLLImportAttribute, puede especificar el nombre de 
la DLL y de la función DLL que debe usarse en su aplicación C#. Igual que el 
acceso al API Win32 en VB6. debe saber el nombre de la DLL y la función de la 
DLL que se quiere ejecutar Una vez ha logrado esto, puede llamar simplemente a 
la función usando el atributo DLLImport en un método señalado con modifica¬ 
dores estáticos y externos, como muestra el siguiente codigo: 


us inq System.Runt. 

i. me . Inte ropSe r v i 

c e s 

; 


í p 111 mp o r t. ( " u s e r 3 

:. el L1 " ) J 




p 11 blie stat i c: tít c- 

■ rn i nt Me.ssacjeB 

o:-: i 

mt 

hW: 

S t: r i n q c a p 1 .1 o n , 

uiiit tvpe't ; 





Cuando usa la invocación de plataforma, puede necesitar cambiar el compor¬ 
tamiento por defecto de la interoperabilidad entre el codigo gestionado y el no 
gestionado. Esto puede conseguirse modificando los campos de la clase 

PLLImp ortAttribute. 

La tabla 34.4 describe los campos de la clase DLLImportAt tribute que 
pueden ser personalizados. 

Tabla 34.4. Campos DLLImportAttnbute 


Campo de objeto Descripción 


EntryPoint 

Especifica el punto de entrada de la DLL a la que 
se va a llamar. 

CharSet 

Controla el modo en que los argumentos de cade¬ 
na deben ser organizados para la función. El valor 
por defecto es CharSet .Ansí. 

ExactSpelling 

Evita que un punto de entrada se modifique para 
que corresponda con el conjunto de caracteres. El 
valor por defecto varía dependiendo del lenguaje 
de programación. 

CallingConvention 

Indica el valor de convención de llamada utilizado 
para pasar los argumentos del método. El valor por 






Campo de objeto 


Descripción 


defecto es winAPi, que se corresponde a to 
stdcall para las plataformas Intel basadas en 
32 bits. 

PreserveSig Indica que la firma administrada del método no se 

debe transformar en una firma no administrada que 
devuelve hresult y que puede tener un argumen¬ 
to adicional [out , retval] para el valor devuel¬ 
to. 

El valor por defecto es True (la firma no se puede 
modificar). 

SetLastError Permite al invocador usar la función API Marshal. 

GetLastwin32Error para determinar si se pro¬ 
dujo un error mientras se ejecutaba el método. En 
Visual Basic, el valor por defecto es True; en C# y 
C++, el valor por defecto es False. 


La operación de llamar a funciones DLL desde C# es similar a hacerlo desde 
Visual Basic 6. Sin embargo, con el atributo DLLImport sólo esta pasando el 
nombre de la DLL y el método que debe llamar 


NOTA: Se recomienda que las llamadas de función DLL estén agrupadas 
en clases separadas. Esto simplifica la codificación, aísla las llamadas de 
función externas y reduce la carga. 


Resumen 

Este capítulo describe cómo usar objetos COM en código NET y cómo usar la 
utilidad Tlbimp para generar ensamblados .NET. También se estudia brevemente 
como interpretar los ensamblados generados. Ademas, se ha explicado cómo es¬ 
cribir código cliente COM en C#. incluyendo llamadas a métodos COM y a traba¬ 
jar con propiedades COM Como puede ver. NET Framcwork permite integrar 
fácilmente el codigo COM existente en sus aplicaciones NET. Esta sencilla inte¬ 
gración le da la oportunidad de mover poco a poco partes de una aplicación a 
NET. sin tener que reescribir toda la lógica de componentes COM de CU. 
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35 


Cómo 


trabajar 
con servicios 

COM+ 


Microsoft ha mejorado mucho la funcionalidad del subsistema COM desde que 
se publico por primera vez en 1ÓÓ3. Una de las mejoras mas significativas intro¬ 
ducidas en el modelo de programación C'OM se introdujo en 1W7 con la publica¬ 
ción de Microsoft Transaetion Server (M I S). MIS. publicado por primera vez 
como complemento de Windows NT 4.0. permitía a los programadores desarro¬ 
llar componentes mediante un intermediario que proporcionaba transacciones, 
seguridad basada en funciones y servicios de agrupación de recursos. 

Con la publicación de Windows 2000. Microsoft elev o el modelo de programa¬ 
ción que ofrecía M I S a un subsistema de primera clase. COM + es. en gran parte, 
una combinación del modelo de programación COM tradicional \ el modelo de 
programación MTS. Por primera vez. Windows proporcionaba compatibilidad 
con los dos componentes C’OM (o no configurados) tradicionales con componen¬ 
tes atribuidos (o configurados) del estilo M I S directamente desde el sistema ope¬ 
rativo. NET Framevvork ofrece ambos estilos de componentes a los programadores 
que escriben software basado en componentes. Este capítulo estudia cómo desa¬ 
rrollar clases C# que pueden usarse como componentes configurados con COM t. 


ADVERTENCIA: Aunque NET Framework está disponible en muchas 
plataformas de sistemas operativos, COM+ no está disponible en el mismo 
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conjunto de plataformas. Los componentes escritos en CU que aprovechan 
los servicios COM+ sólo pueden ser usados en plataformas que admiten 
COM+. El código de la clase COM+ compilado en NET Framework inicia 
una excepción de clase PlatformNotSupported si el código intenta 
acceder a una característica que no existe en la plataforma de tiempo de 
ejecución. 


El espacio de nombres 
System.EnterpriseServices 

Cualquier clase CU puede ser usada por clientes COM como un componente 
COM. independientemente del árbol de herencia de la clase. Las clases CU solo 
pueden derivarse de System. Object y seguir siendo usadas como componen¬ 
tes COM. Sin embargo, aprovechar los servicios COM+ en clases CU requiere 
unas normas de herencia mas rigurosas. 

El espacio de nombres System. EnterpriseServices proporciona las 
clases, enumeraciones, estructuras, delegados e interfaces necesarias para escri¬ 
bir aplicaciones que aprovechen COM+ y sus servicios de nivel de empresa. Si ha 
escrito componentes en C++ o Visual Basic 6 que terminarán ejecutándose en un 
tiempo de ejecución de serv icios COM+. la mayor parte de este capitulo le resul¬ 
tara familiar. Desde el punto de v ista de un programador de COM+ experimenta¬ 
do. el espacio de nombres System. EnterpriseServices contiene la 
funcionalidad a la que antes tenía acceso mediante programación. Si ha escrito 
componentes en VB6. le alegrará saber que las características que anteriormente 
no estaban disponibles, como la agrupación de objetos, ahora están a su entera 
disposición mediante Framework. Servicios como la activación justo a tiempo 
(JIT). la agrupación de objetos, el procesamiento de transacciones y la adminis¬ 
tración de propiedades compartidas están disponibles como clases o atributos en 
el espacio de nombres System. EnterpriseServices. 

La tabla 3rv I describe cada una de las clases disponibles en el espacio de 
nomb res S y s t c m . E nterpriseServices. 


Tabla 35.1. Clases System.EnterpriseServices 


Clase 

Descripción 

ApplicationAccessControlAttribute 

Permite establecer una configuración 
de seguridad para la biblioteca o apli¬ 
cación de servidor que alberga la apli¬ 
cación. No se puede heredar esta clase. 
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Clase 


Descripción 


ApplicationActivationAttribute 

Application I DAttribute 

ApplicationNameAttribute 

ApplicationQueuingAttribute 

AutoCompleteAttribute 

BYOT 

ComponentAccessControlAttribute 

COMTIIntrinsicsAttribute 

ConstructionEnabledAttribute 

ContextUtil 

DescriptionAttribute 


Especifica si los componentes del en¬ 
samblado se ejecutan en el proceso del 
creador o en un proceso del sistema. 

Especifica el identificador de la aplica¬ 
ción (como GUID) para este ensambla¬ 
do. No se puede heredar esta clase. 

Especifica el nombre de la aplicación 
COM+ que se utilizará para la instala¬ 
ción de los componentes del ensam¬ 
blado. No se puede heredar esta clase. 

Habilita el uso de una cola para el en¬ 
samblado marcado y permite a la apli¬ 
cación leer llamadas a métodos desde 
colas de Message Queue Server. No 
se puede heredar esta clase. 

Marca el método con atributos como 
un objeto AutoComplete. No se pue¬ 
de heredar esta clase. 

Ajusta la Clase ByotServerKx y las 
interfaces DTC je reatewith- 
Transact ion Ex y I Cr ea t.eWi t hTip- 

TransactionExde COM + . No se puede 
heredar esta clase. 

Habilita la comprobación de seguridad 
en las llamadas a un componente. No 
se puede heredar esta clase. 

Permite pasar propiedades de contex¬ 
to desde el Integrador de transaccio¬ 
nes COM (COMTI) al contexto de 
COM+. 

Habilita la posibilidad de construcción 
de objetos COM + . No se puede here¬ 
dar esta clase. 

Obtiene información acerca del contex¬ 
to de objetos de COM + . No se puede 
heredar esta clase. 

Especifica una descripción para un en¬ 
samblado (aplicación), componente, 
método o interfaz. No se puede here¬ 
dar esta clase. 
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Clase 


Descripción 


EventClassAttribute 

EventT rackingEnabledAttribute 

ExceptionClassAttribute 

MSI ntri nsicsAttri bute 

InterfaceQueuingAttribute 

JustlnTimeActivationAttribute 

Load Bala ncingSupportedAttri bute 


MustRunlnClientContextAttribute 

ObjectPoolingAttribute 

PrivateCom pone ntAttri bute 


RegistrationErrorlnfo 


Marca la clase con atributos como una 
clase de eventos. No se puede here¬ 
dar esta clase. 

Habilita el seguimiento de eventos para 
un componente. No se puede heredar 
esta clase. 

Establece la clase de excepción de cola 
para la clase en cola. No se puede he¬ 
redar esta clase. 

Permite el acceso a valores intrínse¬ 
cos de ASP desde Conteztut i 1 . 
Ge t Namecl P r op e r t y • No se puede 
heredar esta clase. 

Habilita la capacidad de utilizar una 
cola para la interfaz marcada. No se 
puede heredar esta clase. 

Habilita o deshabilita la activación jus- 1 
to a tiempo (JIT). No se puede heredar 
esta clase. 

Determina si el componente participa 
en el equilibrio de carga, en caso de 
que el servicio de equilibrio de carga 
de componentes esté instalado y habi¬ 
litado en el servidor. 

Obliga a crear el objeto con atributos 
en el contexto del creador, si es posi¬ 
ble. No se puede heredar esta clase. 

Habilita y configura el agrupamiento de ' 
objetos para un componente. No se 
puede heredar esta clase. 

Identifica un componente como com¬ 
ponente privado que sólo puede ser 
visto y activado por otros componen¬ 
tes de la misma aplicación. No se pue¬ 
de heredar esta clase. 

Recupera información de error exten¬ 
dida sobre métodos relativos a múlti¬ 
ples objetos COM + . Esto también 
incluye métodos que instalan, impor¬ 
tan y exportan componentes y aplica- 
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Clase 

Descripción 


clones COM+. No se puede heredar 
esta clase. 

RegistrationException 

Excepción que se produce cuando se 
detecta un error de registro. 

RegistrationHelper 

Instala y configura ensamblados en el 
catálogo de COM+. No se puede here- ; 
dar esta clase. 

ResourcePool 

Almacena objetos en la transacción 
actual. No se puede heredar esta clase. 

SecureMethodAttribute 

Garantiza que la infraestructura reali¬ 
ce las llamadas por medio de una 
interfaz para un método o para cada 
método de una clase cuando se utiliza 
el servicio de seguridad. Las clases 
necesitan utilizar interfaces para poder 
usar los servicios de seguridad. No se 
puede heredar esta clase. 

SecurityCalIContext 

Describe la cadena de llamadores que : 
conducen hasta la llamada al método 
actual. | 

SecurityCallers 

Suministra una colección ordenada de 
identidades en la cadena de llamadas 
actual. 

Securityldentity 

Contiene información relativa a una 
identidad incluida en una cadena de lla¬ 
madas de COM+ 

i 

SecurityRoleAttribute 

Configura una función para una apli¬ 
cación o un componente. No se puede 
heredar esta clase. 

ServicedComponent 

Representa la clase base de todas las 
clases que utilizan servicios de COM+. 

Serví cedComponentException 

Excepción que se produce cuando se 
detecta un error en un componente que 
utiliza servicios. 

SharedProperty 

Obtiene acceso a una propiedad com¬ 
partida. No se puede heredar esta clase. 

SharedPropertyGroup 

Representa una colección de propie¬ 
dades compartidas. No se puede here¬ 
dar esta clase. 
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Clase 


Descripción 


SharedPropertyGroupManager 

Controla el acceso a grupos de propie¬ 
dades compartidas. No se puede here¬ 
dar esta clase. 

SynchronizationAttribute 

Establece el valor de sincronización del 
componente. No se puede heredar esta 
clase. 

T ransactionAttribute 

Especifica el tipo de transacción que 
está disponible para el objeto con atri¬ 
butos. Los valores permitidos son 
miembros de la enumeración Tran- 


sactionOption. 


Si va a escribir clases que se ejecutan en servicios COM+. estará escribiendo 
lo que se conoce como componentes que usan servicios. Los componentes que 
usan servicios aprovechan las características del espacio de nombres 
System. EnterpriseServices y le permiten usar las características em¬ 
presariales de COM+. 

La clase ServicedComponent 

Cualquier clase diseñada para aprovechar los serv icios de COM+ debe deri¬ 
varse directamente de ServicedComponent o de una clase que tenga 
ServicedComponent en alguna parte de su árbol de herencia Todos los 
servicios COM+ que puede usar están disponibles asignando atributos a las cla¬ 
ses que se derivan de la clase ServicedComponent. 

La clase Serví cedComponent no admite ninguna propiedad; sin embar¬ 
go. admite una serie de métodos públicos que pueden ser invocados por clientes de 
clase. La mayor parte de estos métodos, incluyendo Activa te ( ) . 
Deacti vate ( ) y CanBePooled ( ¡ . describen los métodos definidos por 
interfaces COMt. como IOb j ectControl. Estos métodos son v irtuales y pue¬ 
den ser reemplazados por clases derivadas para proporcionar funcionalidad espe¬ 
cífica. 

El listado 35 1 muestra una sencilla clase COMt escrita en CU. Este objeto 
participa en el agrupamiento de objetos COMt. 

Listado 35.1. Componente COM+ agrupable en C# 

tus i ng System. EnterpriseServices ; 

[ Ob j e c t Pool i ng { 5 , 1 0 ) ] 

pub 1 i c r; l a s s P o o 1 e elC1 a s s : Serv i ceelC omponen t 
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puh lie Pool e dC 1 as s t ) 


{ 

} 


■- PooledCidss ( ) 
) 


p u b lie ovetnde b o o 1 CanEePooied ( i 


retuin t; r u e ; 


pub 1 1 rj o v o r r i d e voi d Ac 1i va te!) 

I 

} 


p u b Lie over r i d e v o i d D e a e t i v a t e ( i 


} 

La clase del listado 35 1 usa un atributo de NET Eramevvork llamado 
Oh j ect Pooling para indicar que la clase Poo i ede: i ass debe poder agru¬ 
parse en COM+ El atributo Obj ect Poo l i nq admite varios constructores. El 
listado 35.1 usa el constructor que acepta dos números enteros que representan el 
tamaño máximo y mínimo de la agrupación. El codigo usa los valores 5 y 10. lo 
que indica a COM+ que debe admitir un mínimo de cinco y un máximo de diez 
objetos de esta clase en la agrupación de objetos ( OM b 

Eos componentes COM + escritos en CU que quieren formar parte de una agru¬ 
pación de objetos COM+ deben reemplazar al método virtual OanBePoo 1 ed ; } 
de la clase base Serví cedComponent y deben devolver Truc. Si se devuelve 
un valor False significa que el componente no debe formar parte de la agrupa¬ 
ción de objetos. 

Los componentes COM+ que pueden ser agrupados también pueden reempla¬ 
zar a los métodos Ser vi. cedComponent virtuales llamados Acti vate ; > y 
Deact i vate ( ) . El método Actívate f) es invocado cuando el objeto es 
eliminado de la agrupación de objetos y asignado a un cliente y el método 
Deact i vate ( ) es invocado cuando el objeto es liberado por un cliente y de¬ 
vuelto a la aplicación. Debe seguir las directrices impuestas por el desarrollo de 
COM+ estándar y colocar todo el codigo relevante de destrucción y construcción 
de estado de objetos en los métodos Actívate ( ) y reactívate ( ) . El cons¬ 
tructor v destructor de su clase son invocados, pero sólo son invocados una v ez. 
El constructor es inv ocado solo cuando COM + crea instancias de su objeto para 
colocarlas en la agrupación de objetos COM+ y el destructor solo es llamado 
cuando COM-f destruye el objeto tras eliminarlo de la agrupación. El método 
Actívate ( ) se diferencia del constructor en que se invoca cada v ez que la 
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instancia se asigna a un cliente COM + . El método Deactivate ( ) se diferen¬ 
cia del destructor en que se invoca cada vez que la instancia es liberada de un 
cliente COM t- y devuelta a la agrupación de objetos COM+ Si tiene código que 
debe realizar alguna inicializacion cada vez que se le asigna a un nuevo cliente el 
uso del objeto, coloque el codigo en Actívate ( ) . en lugar de en su constructor 
de clase. Del mismo modo, si tiene algún codigo que deba realizar alguna 
desimeializaeion cada vez que un nuevo cliente libere el objeto, coloque el codigo 
en I i t i v:.i t ■ ) . en lugar de en su destructor de clase. 

Cómo registrar clases con COM+ 


Las clases de CU diseñadas para ser usadas en una aplicación COM + deben 
seguir las mismas reglas básicas que las clases de CU diseñadas para ser usadas 
por los clasicos clientes COM En el capitulo anterior se describe como usar CU 
para crear componentes COM. Al igual que los componentes COM escritos en 
CU. los componentes COM + escritos en CU deben compilarse en un ensamblado 
basado en DEL y deben tener un nombre seguro (lo que requiere que el ensambla¬ 
do tenga un par de clave publica e información de versión). Al igual que los 
componentes COM. esta información puede ser especificada para componentes 
COM + mediante atributos especificados en el codigo fuente CU. 

Puede instalar sus clases en una aplicación COM+ mediante una herramienta 
de linea de comando llamada reqsvcs que se incluye en NET Framework. Esta 
herramienta de linea de comando inscribe todas las elases publicas encontradas 
en un ensamblado basado en DLL con COM+ y realiza todas las inscripciones 
necesarias para hacer que las elases sean tan v isibles como las clase COM A 
El listado 35.2 es una pequeña modificación al listado 35.1. Contiene los atri¬ 
butos necesarios para preparar el ensamblado generado para que admita un nom¬ 
bre seguro. 

Listado 35.2. Objeto COM+ agrupable con atributos de nombre seguro 

us i n q S y s tv o m .Peí 1 o c 1 1 o n ; 
u s ing Systom.Entcrpris eServices; 

j a s s e mb 1 y : A s .s o mí > 1 y K e y File í " k e y f i 1 e . s n k " ) ] 

[ a s s emb i y : As s o mb 1 y Ve i s i on f " 1 . u . * " } 

[ Oh j e c t Pool mg ( 5, 1 0 ) ] 

pi; b!ic c1 a s s Poole dC1a ss : ServicedComponen t 
/ 

pi ¿ b 1 i o P o o 1 e d C1 a s s ( ) 

{ 

} 


• p o o J e d C 1 a s s í i 
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{ 

} 

public ove r; r i de bool CanBePooled ( i 
{ 

return true; 
i 

public over rifle v o i el Actívate () 

{ 

} 

public over riele void Deactivat.e |$ 


I 

Puede exponer esta elase como una clase C'OMi con solo unas cuantas herra¬ 
mientas de línea de comando. En primer lugar, genere un nuevo par de claves para 
el nombre seguro del ensamblado con la herramienta de línea de comando estándar 

s n: 


sn -k k e y file.snk 

A continuación, compile el codigo en un ensamblado basado en DEL 

c s c /tdiqct : librar y List i n g 3 S - 1 . c s 

I ras generar el ensamblado, puede usar la herramienta roasvr.s para regis¬ 
trar el ensamblado con COM t : 

r e c í s v c s / a pp ñame : T, i s t i í$q 1 Ü - 2 A p p L i s tm cj '■! 1 > 2 . r\ Ij| 


TRUCO: La infraestructura de interoperabilidad NET/COM+ admite apli¬ 
caciones COM+ basadas en la caché de ensamblados global. Si varios clien¬ 
tes usan el código, quizás quiera instalar su ensamblado en la caché de 
ensamblado global antes de registrarla con COM+. 


El argumento /appname para la herramienta t rasves especifica el nom¬ 
bre de la aplicación COM+ creada para almacenar las clases publicas encontra¬ 
das en el ensamblado. Si cuando se ejecuta regsvcs ya existe una aplicación C ONE 
con su nombre, las clases se agregan a la aplicación preexistente La figura . 1 
muestra el explorador COM+ ejecutándose con el ensamblado generado a partir 
del código del listado 35.2 registrado con COM t . I >'|f od 1 '* 1 mss es detectado 
automáticamente por el proceso de registro y agregada a la aplicación COM t 
Inicie el explorador COM+ realizando los siguientes pasos: 

1 Haga clic en el botón Inicio del Explorador de Windows. Aparecerá el 
menú Inicio. 
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Figura 35.1. Explorador COM+ con un ensamblado NET registrado 


2. Escoja Programas>Herramientas administrativas. Aparecerán los 
iconos de las aplicaciones en el grupo de programas Herramientas admi¬ 
nistrativas 

3. Seleccione Servicios de componentes. Aparecerá el Explorador COM+. 

La figura 35.2 muestra la hoja de propiedades de la clase PoolcdClas.s. 
Observe que la información de agrupación de objeto especificada en los atributos 
del listado 35.2 es detectada automáticamente por el proceso de registro y agrega¬ 
da a la aplicación COM+. 

Cómo usar atributos para clases COM+ 

El atributo de agrupación de objetos usado en el listado 35.2 solo es uno de los 
muchos atributos .NET que puede usar en sus clases C#. NET Framework admi¬ 
te varios atributos que pueden usarse para configurar aspectos COM+ para sus 
clases CU. Todos los atributos NET relativos a COM + se incluyen en el espacio 
de nombres System* F.ntorpr i seGorvicos. Las siguientes secciones des¬ 
criben más atributos interesantes del servicio COMt. 


NOTA: Para los atributos COM+ del espacio de nombres System. 
EnterpriseServices, el valor predeterminado sin configurar hace 
referencia al valor que COM+ asigna al atributo cuando el atributo no 









aparece en el código. Un valor predeterminado configurado hace referencia 
al valor asignado al atributo, si se asigna, pero omite su valor. 


■ _?j*J 

General | Transacciones | Seguridad 

Activación | Simultaneidad j Avanzado 

F Habilitar agrupación de objetos 
Tamaño mínimo del grupo: [i - 1 

Tamaño máximo del grupo: y 11 

Tiempo de espera para la creación (cns): |b' li l111 - 1 

F Habilitar construcción de objetos 


Contexto de activación 
s * No forzar el contexto de activación 
! El componente admite eventos y estadísticas 
F Habilitar activación puntual 
í Debe activarse en el contexto del autor de la llamada 
r Debe activarse en el contexto predeterminado 

f Marcar el componente como privado para la aplicación 

I^Acepta^Jj Cancelar j Aplicar j 

Figura 35.2. Página de la propiedad de clase COM+ con información de agrupación 

de objetos 

ApplicationAccessControl 

El atributo Applicdt¡|onAccessControi especifica si se puede confi¬ 
gurar lá seguridad de un ensamblado. Este atributo recibe un valor booleano que 
debe ser True si se permite la configuración de seguridad \ Falso en easo 
contrario. El valor predeterminado no configurado es Fa ■ so- \ el \alor predeter¬ 
minado configurado es True. 

ApplicationActivation 

El atributo AppII oat ionAct i. vat ion es un atributo de nivel de ensam¬ 
blado que especifica si se debe agregar la clase a una biblioteca o a una aplicación 
de servidor COM + . El atributo recibe como parametro un tipo de enumeración 
llamado Act ivat ionOpt ion que admite los siguientes valores: 

• Library. que especifica una aplicación de biblioteca COM T 

• Server, que especifica una aplicación de sen idor COM i 

El valor predeterminado no configurado es Librar y. 
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ApplicationID 

El atributo ApplicationID puede usarse para especificar el GUID que se 
va a asignar a la aplicación ( OM t creada para que contenga la clase COM+ El 
GUID se especifica usando su representación de cadena, que se envía al construc¬ 
tor del atributo. El atributo ApplicationID debe aplicarse en el nivel de 
ensamblado, como en el siguiente fragmento de codigo: 

[asscmbly: Appl i cationlD ( " { E 3 8 6 8 E 1 9 - 4 8 6 E - 9 F1 3 -- FC 8 4 4 3 1 1 3 7 3 1 } " ) ] 
p u b 1 i c: rj I a 3 3 M yC 1 a s s 
{ 

! 


El atributo recibe una cadena como parámetro que describe el GUID de la 
aplicación. 

ApplicationName 

El atributo Appl i cationName se utiliza para especificar el nombre que se 
va a asignar a la aplicación COM+ creada para que contenga la clase COM+ Se 
le debe proporcionar el nombre del constructor del atributo. Si se especifica este 
atributo en el codigo. no sera necesario usar el argumento /appnarre de la 
herramienta de linea de comando recpsves. 

El atributo Appl : cat ionName debe aplicarse en el nivel de ensamblado, 
como en el siguiente fragmento de codigo: 

.3 emb 1 y : App 1 .1 a t i añílame ( "MyName " ) ] 
p ub lie ?: I a 5; .s M y C: 1 a a .s 


El atributo recibe como parametro una cadena que describe el nombre de la 
aplicación y su valor predeterminado es el nombre del ensamblado para un valor 
predeterminado no configurado. 

ApplicationQueuing 

El atributo Appl i car iongucuing se usa para especificar que la clase 
debe ser configurada como un componente en cola. El atributo no admite 
parametros. El atributo App 1 : >.D: i cngucu i nq debe aplicarse en el nivel de 
ensamblado, como en el siguiente fragmento de codigo: 

j a s 3 íub 1 y : App 1 i s a t 1 - <nvu a a i 11 g ' 
p libllC f 1 a s s M y C 1 a a S 
! 

} 

El atributo no admite parametros. 
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AutoCom píete 


El atributo AutoOomp] ete puede aplicarse a métodos en una clase C OM t 
Si la llamada de método se hace en el ámbito de una transacción y la llamada de 
método se completa con normalidad, las llamadas a métodos marcados como 
métodos AutoCompl. ote van inmediatamente seguidas por una llamada de NI I 
Framework a SetComplot o ( ) . No es necesario realizar una llamada explícita 
a 3etCorr.pl ete ( ) para los métodos Aut. oCornpiot o. Si un método 
Aut oCompl e te ( ) inicia una excepción, se invoca a SetAborf ( ) y la tran¬ 
sacción es eliminada. Hl atributo AutoCornp 1 ote debe aplicarse en el nivel de 
método, como en el siguiente fragmento de codigo: 

pul ií : . • ! , 1 SH KyCtiss 

1 

[Aut.. oC emp 1 o t o ] 
pub 1 i MyMe 1 hod ( ) 

\ 

1 

í 

Hl atributo AutoComplcto no acepta parametros. Hl valor por defecto para 
el valor predeterminado no configurado es Fu 1 se y para el valor predeterminado 
configurado es True. 

ComponentAccessControl 

Hl atributo ComponentAcces sCont r o activa o desactiva las comproba¬ 
ciones de segundad en las llamadas a instancias de clase. Hl atributo recibe como 
parametro un v alor booleano. que debe ser Truc si la comprobación del nivel de 
seguridad de la llamada debe estar activa o Fa 1 se en caso contrario. 

Hl atributo Component AccessCont ro 1 debe aplicarse en el nivel de cla¬ 
se. como en el siguiente fragmento de codigo: 

[ComponentAccessCont rol] 

p ubJ ic class MyClass 

1 

} 

Hl atributo ComponentAccessControl no acepta parametros. Hl valor 
por defecto para el valor predeterminado no configurado es Falso y para el 
valor predeterminado configurado es True. 

ConstructionEnabled 

El atributo ConstructionEnabled permite la construcción de objetos 
COM + . El mecanismo de construcción de objetos COMt permite que se pueda 
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pasar una cadena como cadena de constructor a las instancias de objetos con 
instancias. El atributo no especifica la cadena: en cambio, simplemente permite 
que se admita la construcción de objetos COM+. El atributo admite un valor 
booleano como parametro, que debe ser True si la construcción de objetos COM + 
debe estar activada para la clase y Pa l se en caso contrario. Las clases de C# 
que admiten la construcción de objetos deben implementar la interfaz 
lüb jeePConst: r uct. El método Construct () de la interfaz es imocado 
por COM+ para pasar la cadena de constructor al objeto. 

El atributo Cons t r uct i onPnab 1 od debe aplicarse en el nivel de clase, 
como en el siguiente fragmento de codigo: 

| O -i n s t ) \ .1 ■' : t ; o n F, i i a b 1 o d ] 

p u b i i c <: J a ti ti M y C1 a s s 

1 

El atributo Cons t ruc: t i onFnab 1 od no admite parámetros El valor por 
defecto del valor predeterminado no configurado es False y el del valor prede¬ 
terminado configurado es True. 

JustlnTimeActivation 


El atributo 'JustlnTimeActivation habilita o deshabilita la actuación 
justo a tiempo (JIT) de una clase. El atributo admite un valor booleano como 
parametro, que debe ser True si se va a permitir la activación JIT en la clase y 
Fa i so en caso contrario. Ea activación JIT siempre debe estar habilitada en los 
objetos que toman parte en transacciones. 

El atributo Just 1 nTimeActivation debe aplicarse en el nivel de clase, 
como en el siguiente fragmento de código: 

í J uy t; InTi me Aef i. vaf. i on ] 
pub 1 i <: el a.s s MyC 1 as s 
í 
} 

El atributo dunt TnTineAct.: va:, i on no admite parametros. El valor por 
defecto para el valor predeterminado no configurado es False y para el valor 
predeterminado configurado es Tr ue. 

LoadBalancingSupported 

El atributo LoariBa ; anci nq.Supoorted habilita o deshabilita la compa¬ 
tibilidad con el equilibrio de cargas de una clase. El atributo admite un valor 
booleano como parametro que debe ser True si la compatibilidad con el equili¬ 
brio de cargas va a estar habilitada y Fa 1 se en caso contrario. 
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El atributo LoadBa 1 andngSupported debe aplicarse en el nivel de cla¬ 
se. como en el siguiente fragmento de código: 

[LcadBalancingSupportedJ 
p ub lie c-1 a s s MyCla s s 
i 
} 

El atributo LoadDalancingSupported no admite parámetros. El valor 
por defecto para el valor predeterminado no configurado es Falso y para el 
valor predeterminado configurado es True. 

SecurityRole 

El atributo SecurityRole especifica una función de seguridad. Este atri¬ 
buto puede aplicarse a una clase, un método o un ensamblado completo. El cons¬ 
tructor recibe como argumento una cadena que debe especificar el nombre de la 
función a la que deben pertenecer los miembros, como muestra el siguiente frag¬ 
mento de codigo: 

[ as s emb ly: Securit y Rol e ( "MyS ecuntyRole" ¡ J 
public class MyClass 
{ 

} 

Cómo procesar transacciones 


La compatibilidad de transacciones de COM+ fue uno de los principales res¬ 
ponsables de su popularidad. Gracias a la compatibilidad de transacciones, puede 
escribir código que realice mas de una tarea, pero la aplicación lo ve como una 
sola unidad de trabajo, como actualizar una base de datos y borrar un registro en 
otra tabla de una base de datos completamente distinta. Con las transacciones, 
puede garantizar que se v a a aplicar un modelo de todo o nada en estas situacio¬ 
nes. Si la eliminación falla en la segunda base de datos, la actualización de la 
primera base de datos también es cancelada. 

Sin las transacciones, los datos podrían no compararse correctamente y no 
podría escribir aplicaciones de nivel de empresa. Una de las primeras aplicacio¬ 
nes de ejemplo en usar la compatibilidad de transacciones que publico Microsoft 
se llamo ExAir. ExAir es una compañía aérea ficticia. El concepto básico tras la 
aplicación es un agente de billetes que recibe reservas de vuelos. Cuando un 
cliente solicita un vuelo, también debe solicitar un tipo de comida, como carne, 
vegetariana o pasta. La parte de comida de la aplicación intenta introducir los 
datos en una base de datos distinta de la base de datos con el diagrama de asientos 
de la compañía aérea. La base de datos diferente representa una transacción dis- 


761 



tribuida a otra compañía, el proveedor de alimentos. Si el primer método contiene 
eodigo que introduce la petición de billete en la base de datos de la línea aerea. \ 
un segundo método contiene eodigo que intenta introducir datos en la base de 
datos del proveedor de alimentos, ¿qué ocurrirá si no se encuentra la base de 
datos del proveedor de alimentos? La información original que contiene los deta¬ 
lles del \ uelo se introducirá en la base de datos de la compañía aerea, pero cuando 
los pasajeros aparezcan, no tendrán comida, porque la segunda parte de la tran¬ 
sacción no se pudo realizar. Evidentemente, esto no es una situación deseable 
para una aplicación de empresa. Si el proveedor de alimentos no esta disponible, 
el billete no se introducirá en la base de datos de la compañía aerea. Este proble¬ 
ma puede solucionarse fácilmente envolviendo las dos llamadas de método en una 
transacción. 


NOTA: En el ejemplo ExAir, a la compañía no le interesa dejar de reservar 
un billete sólo porque el vínculo a la base de datos de su proveedor de 
alimentos no funciona. En esta situación, la solución podría ser usar algo 
como los componentes en cola o Microsoft Mcssage Queue. Con los servi¬ 
cios Message Queue. que se incluyen en el espacio de nombres 
System.Messaging„ puede garantizar la petición eventual de envío de 
comida enviándola a una cola de mensajes en lugar de intentar escribir 
inmediatamente los datos en la base de datos remota. Con este tipo de 
arquitectura, la aplicación siempre puede aceptar las peticiones de billetes 
V el proveedor sólo tendrá que extraer mensajes de la cola de mensajes 
cuando pueda procesar los pedidos de alimentos. 


Propiedades ACID 

Para que funcionen las transacciones, deben atenerse a las propiedades ACID 
ACID es el acrónimo de atomicidad, coherencia, aislamiento y permanencia La 
tabla 35.2 describe las definiciones de las propiedades ACID 

Tabla 35.2. Propiedades ACID 


Propiedad 

Descripción 

Atomicidad 

Todo el trabajo es atómico o sucede en una sola 
unidad de trabajo. 

Coherencia 

Todo dato que se usa en la transacción es abando¬ 
nado en un estado consistente. 

i Aislamiento 

Cada transacción está aislada de las otras transac¬ 
ciones, lo que permite que las transacciones pue- 
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Propiedad Descripción 


dan sobrescribir los datos de otros procesos, lo que 
mantiene la uniformidad. 

Permanencia Cuando se completa la transacción, todos los da¬ 

tos deben estar en un almacén permanente, como 
una base de datos. Si la transacción falla, todos los 
datos usados en ella deben ser eliminados. La per¬ 
manencia garantiza que los datos sobrevivan a 
acontecimientos imprevistos, como cortes de luz o 
huracanes. 


Cómo escribir componentes 
de transacciones 


FJ atributo Transacr, i on especifica un ni\ el de compatibilidad con tran¬ 
sacciones que debe estar disponible para este objeto, hl atributo recibe como 
parametro un valor de una enumeración en el espacio de nombres r.yst.erm 
F,nt.eroriseServi ces llamado Transad i oníipt i or| que es compati¬ 
ble con cualquiera de los siguientes valores: 

• Di sao 1 ed. que especifica que el objeto debe pasar por alto cualquier 
transacción en el contexto actual 

• NotSupport.ed. que especifica que el objeto debe crear el componente 
en un contexto sin una transacción que lo controle 

• RequirecL que especitica que el objeto debe compartir una transacción 
si va existe una o crear una nueva transacción en caso de que sea necesario 

• RequiresNew. que especifica que el objeto debe crear el componente 
eon una nueva transacción, independientemente del estado del actual con¬ 
texto 

• Supported. que especifica que el objeto debe compartir una transacción 
si ya existe una 

El atributo Transaction debe aplicarse en el nivel de clase, como en el 
siguiente fragmento de código: 

1 Transact ion (Transact i onOpt i on . Support ed.i ] 

pub1ic c1 a s s MyC1 a ss 

í 

} 
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El atributo recibe un solo parámetro que nombra a un valor de la enumeración 
Transacti onOpt i on y describe el nivel de transacción que admite el diseño 
de la clase. El atributo también puede usarse sin parámetros, como en el siguiente 
fragmento de codigo: 

[ T r an.s a c t i on ] 
p u b 1 i c: o 1 a .y s My C1 a s s 


| 

Si se especifica el atributo Transaction sin especificar un parámetro, el 
nivel de compatibilidad con el parámetro de la clase pasa a ser Required. 

El listado 35.3 muestra el código completo para el contexto de E:-:Ai r. Exis¬ 
ten dos métodos y cada uno accede a recursos diferentes. Como están contenidos 
en una transacción, queda garantizado que el procesamiento del pedido tiene lu¬ 
gar como una sola unidad de trabajo; el proceso esta aislado de los otros posibles 
pedidos; los datos del pedido se dejan en un estado coherente; y una vez que el 
pedido esta consignado, permanecen en un almacén permanente. 

Listado 35.3. Ejemplo de base de datos transaccional 

namespace T ransactionSupport 

i 


iisincj System; 

us i nq 5;ystem. Da t. a . S q ] C 1 lent ; 
u s i n cj S ystem. Ente rpr i seServi c c- s ; 

[ Transa c t i o n ( T r a n s a c t.. i onOptio n .Required) ] 
pub ] i c c 1 a s s E A i rM din : Se rvicedC omp o n e n t 
{ 

pub 1 i o v o i d P r oce s s ( J 
{ 

/* 1 lama a métodos para agregar información de Food y de 

Ticket V 


AddFood processf - new AddFood() ; 

AddAi rl me process2 = new AddAirline () ; 

procesa 1 .Add ( ) ; 
proce s s2.Ad d () ; 


1 


} 


[ T ransact. i on ( Tr ansact i onOpt ion . Suppor ted ) ] 
f AutoC omp1e t e] 

public class AddFood : ServicedComponent 


( 

public v o i d Add f ) 
í 
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new 


SQLConnection cnn = 

SQLConnec t .i on ( "Foods upp 1 1 e r C onn e c 1 1 on " ¡ ; 

S Q L C o mm and c md = new S Q L C omnia n d í 1 ; 
cnn.Open(); 

cmd.ActiveConne c tion - cnn; 

cmd.C omraandText = // Introduce una instrucción en jB 

r; md . E xecuteNonQuer y ( ) / 
cnn.Glose ( ) ; 



[Transad, ion (TransactionOption.Supported) | 

[Au t o C omp tete] 

public class AcldAirlme : ServicedComponent 
{ 

pub1 ic void Add() 

i 

SQTjConnect ion cnn - new 
SQLConnection ("AirlmeConnection " j ; 

SQTiCommand cmd = new SQLCommand ( ) ; 
cnn.Open ( ) ; 

cmd . Ac tuveCo n nectio n = c nn ; 

c md.Co mm anclTe x t = "" // Introduce una instrucción en I>R 

cmd.ExecuteNonQuery( ) ; 
cnn.CLose(); 

} 

\ 

} 


Cómo acceder al contexto de objetos 


El espacio de nombres System. EnterpriseServices incline una cla¬ 
se llamada ContextUtil que puede ser utilizada por clases C# para acceder a 
un contexto de tiempo de ejecución COM+ de un objeto. En Visual Basic 6. se 
accede al contexto de objetos del componente en uso mediante el objeto 
ObjectContext. como muestra el siguiente codigo: 

Dim ctx as ObjectContext 

ct.x - GetOb j ectCont ext 

La clase ContextUtil contiene varias propiedades y métodos que conce¬ 
den a los ¡mocadores el acceso a información de estado de contexto COM+ 
Todos los métodos y propiedades de la clase son estáticos, lo que significa que se 
puede acceder a los miembros directamente desde la clase ContextUti 1 sin 
crear un objeto de la clase. La tabla 35.3 describe las propiedades de la clase 
ContextUtil y la tabla 35.4 describe los métodos de la clase ContextUt i i. 

El código del listado 35.4 implementa un componente COM+ transaccional 
que implementa un método publico llamado DoWork ( ) . El método DoWork ( ) 
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comprueba la propiedad 1 sCaller InRole ( ) para determinar la función C'OM+ 
del unocador. Si la función del invocador esCi ientRole. entonces la transac¬ 
ción del objeto se realiza con una llamada a SetComplete ( ) . Si la función del 
¡mocador es distinta de la de C.L ientRole. entonces la transacción del objeto 
es cancelada con una llamada a SetAbort { ) . 

Tabla 35.3. Propiedades de la clase ContextUtil 


Propiedad 

Descripción 

Activityld 

Obtiene un identificador GUID que representa la 
actividad que contiene el componente 

Application Id 

Obtiene un identificador GUID para la aplicación 
actual 

Applicationlnstanceld 

Obtiene un identificador GUID para la instancia de 
aplicación actual 

Contextld 

Obtiene un identificador GUID para el contexto ac¬ 
tual 

DeactivateOnReturn 

Obtiene o establece el bit hecho en el contexto de 
COM+ ¡ 

IsInTransaction 

Obtiene un valor que indica si el contexto actual es 
transaccional 

IsSecurityEnabled 

Obtiene un valor que indica si la seguridad basada 
en funciones está activa en el contexto actual 

MyTransactionVote 

Obtiene o establece el bit consistente en el contex¬ 
to de COM+ 

Partitionld 

Obtiene un identificador GUID para la partición ac¬ 
tual 

Transaction 

Obtiene un objeto que describe la transacción de : 
DTC actual de COM+ 

T ransactionld 

Obtiene el identificador GUID de la transacción de 
DTC actual de COM+ 

Tabla 35.4. Propiedades de la clase ContextUtil 

1 Propiedad 

Descripción 

DisableCommit 

Asigna a los bits consistente y hecho el valor Fal.se 
en el contexto de COM+. 

EnableCommit 

Asigna al bit consistente el valor : : ue, y al bit hecgi 
el valor False, en el contexto de COM+ 
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Propiedad 


Descripción 


GetNamedProperty 

IsCalíerlnRole 

SetAbort 

SetComplete 


Devuelve una propiedad con nombre desde el con¬ 
texto COM+ 

Determina si el llamador se incluye en la función 
especificada 

Asigna al bit consistente el valor v.-4 v - , y al bit 
hecho el valor Tiue, en el contexto de COM+ 

Asigna a los bits consistente y hecho el valor Ti 
en el contexto de COM+. 


Listado 35.4. Cómo acceder al contexto COM + mediante la clase ContextUtil 

u su: q S y s t. e m .Retí e c t i o 11 ; 

:; s 1 v: q ‘; y s t e ni. bn t e r p r i s o S e r v i<. - s ; 

i a s .s erais 1 y : As s emb 1 f Kr* y F i 1 o { " 1: e y f í 1 e . s :: 1: " ! 

i a ss emb1 y:Ass emb1 yVe:sioni" 1 . u . * " > ] 

í ■, 1 b 7 e r: f p o o 1 i n y (' 5 , i 0 ) ] 

[ T r a r.s a r: r i >m (T r an s a c t .i on ■p t : on . P o qi í i i t - ■ i . I 

[ 51 e r: u r i t y R o le ( "C 1 i e n t R o i e " : j 

p ib 1 i : r; 1. a s s P o o 1 eclC l ass : Ser v i e e d r: o mp o r. e r. t 

p U b 1 l. r: p o O 1 e el C 1 ass ( i 


• Pon 1edC 1 ass f¡ 

í 

} 

p u 11 i i c o v erride h o o 1 (.: a n B e P o o 1 e d t i 
I 

retarn t rué; 


p u ¡di c o ve r r i de v o i d A o f i v ate i 
i. 


p;; b 1 i c over r íde v o id |> e a c t i v a te í i 
I 

| 

pub 1 i c void |lc>Worh() 

I 

bo o I IsTnRole; 
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Is TnRo1e - ContextUtif^ IsCallerInRole("ClientRole”) ; 
if fIslnRole -- t rué} 

Con t_ e x t Util .S etCompie te () ; 

o1. S c 

C on t e x t Util. S e t: Ab o r t j ) ; 


Resumen 


La exposición de una clase C# como si fuera una aplicación C'OM+ no supone 
ningún esfuerzo y resulta mas sencillo que implementar la misma funcionalidad 
usando versiones anteriores de Visual Studio 6.0. Las aplicaciones de C’OM-t 
escritas en Visual C' t + 60 necesitaban mucho mas código para realizar las mis¬ 
mas tareas y algunas características de COM+ (como la agrupación de objetos) ni 
siquiera estaban disponibles en Visual Basic 6.0 

El desarrollo de componentes C'OM t mediante C# implica cuatro sencillos 
conceptos: 

• Derivar la clase de ServicedComponent 

• Agregar atributos para describir las configuraciones de la aplicación 

• Usar la herramienta regsvcs para construir una aplicación COM+ para 
las clases publicas 

• Invocar a métodos y propiedades en la clase Contextuó i i para acceder 
al contexto C'OM + en el tiempo de ejecución. 

Microsoft ofreció pistas sobre este modelo de programación COM+ hasta 1007. 
Entonces, describieron un modelo basado en programación con atributos, en el 
que los componentes COM deberían ser descritos con atributos y el tiempo de 
ejecución se encargaría de detalles como los generadores de clases y el cálculo de 
referencias al estilo lUnknown. Ahora es evidente que el modelo NF.T de desa¬ 
rrollo de componentes C'OM-t es la culminación de esa visión original 
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36 


Cómo 


trabajar con los 

servicios 
remotos de .NET 


NET Framcwork proporciona varios mecanismos que le permiten escribir apli¬ 
caciones que no existen en el mismo dominio de aplicación, procesos de servidor 
o equipo. Basándose en los requisitos de la aplicación, como la capacidad de los 
servidores que no sea de .NET para acceder a sus datos, puede escoger cualquiera 
de los diferentes tipos de métodos de comunicación de objetos. En este capitulo, 
estudiaremos el entorno remoto NET. Al usar un entorno remoto, puede recodificar 
objetos y llamadas de métodos a lo largo de limites de procesos y pasar datos 
entre aplicaciones eficazmente. Anteriormente aprendimos que los servicios Web 
de ASP.NET y XML también eran excelentes medios para pasar objetos y datos 
entre límites de procesos, pero dependiendo de la infraestructura de la aplicación, 
esos servicios podían no ser la mejor opción disponible. El entorno remoto se 
ocupa de los aspectos que no cubrían estos servicios. En este capítulo, aprenderá 
a implementar entornos remotos, a crear los objetos cliente y servidor de un entor¬ 
no remoto y a pasar datos usando el entorno remoto a través de límites de procesos. 

Introducción al entorno remoto 

El entorno remoto .NET permite a las aplicaciones comunicarse entre objetos 
que están en servidores diferentes, procesos diferentes o dominios de aplicación 
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diferentes. Antes de la llegada de NET Framework. se podían pasar objetos a 
través de límites de procesos mediante COM o DCOM. DCOM funcionaba bien, 
pero tenía limitaciones, como los tipos de datos que podían pasarse y el contexto 
de segundad pasado entre el llamador cliente y la activación del servidor Ade¬ 
más. estaba basado en COM. lo que significaba que aunque podía comunicarse a 
través de límites de equipo, todos los equipos debían estar ejecutando un sistema 
operativo de Microsoft, Esto no era una gran limitación, pero limitaba nuestras 
opciones respecto a lo que podíamos hacer con la infraestructura existente. En 
NET. el entorno remoto se ocupa de estos aspectos y mejora lo que DCOM 
ofrecía como un método viable para establecer una comunicación remota entre 
objetos. 

El entorno remoto permite implementar un servidor o una aplicación de servi¬ 
dor v una aplicación cliente. En el servidor o el cliente, la aplicación puede ser 
cualquiera de las plantillas de aplicación NET disponibles, incluyendo aplicacio¬ 
nes de consola, aplicaciones de servicios Windows, aplicaciones ASP NET. apli¬ 
caciones WindowsForms y aplicaciones 11S. En el servidor, se configura mediante 
programación (o se emplea un archivo de configuración para especificarlo) el tipo 
de activación que permitirán los clientes. Los clientes pueden usar uno de los 
varios tipos de métodos de activación, incluyendo Singleton y SingleCall. 
como se explicará en la sección "Cómo activar el objeto remoto." más tarde en 
este mismo capítulo. Es en este punto donde se especifica el canal y el puerto a 
través de los cuales se comunica el objeto y el formato que tendrán los datos 
cuando pasen entre el servidor y el cliente. Aprenderá a implementar canales y 
puertos poco después. El formato de los datos es importante, según el diseño del 
sistema: puede usar datos binarios. SOAP o un formato personalizado, para 
recodificar los datos. Tras especificar el canal, el puerto y el formato, según el 
tipo de servidor remoto que esté exponiendo, debe determinar como exponer los 
metadatos a los clientes. Puede hacerlo de varias maneras, como permitiendo al 
invocador descargar el ensamblado o haciendo que la fuente esté disponible para 
el invocador 

En cualquiera de los dos casos, el cliente debe saber qué objeto está creando, 
de modo que los metadatos en varias formas deben estar disponibles para el invo¬ 
cador. Cuando el serv idor está configurado y creado adecuadamente, puede escri¬ 
bir el cliente. En el cliente, todo lo que debe hacer es crear una instancia del objeto 
en el canal v puerto especificados que esperen peticiones del serv idor Puede 
lograr esto mediante programación o mediante un archivo de configuración. En 
este punto, las llamadas de método no son diferentes de cualquier otro objeto de 
una aplicación NET que se pueda usar. Tras crear objetos, llame a los métodos, 
establezca v recupere propiedades y desencadene eventos igual que haría con un 
objeto que no esté usando el entorno remoto. 

Estos pueden parecer muchos pasos, pero en realidad es muy sencillo una v ez 
que lo ha hecho una vez. Puede resumir todo el proceso en las siguientes tareas, 
esquematizadas en la figura 36.1 
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1. Especifique los canales y puertos que recodifican los objetos entre el servi¬ 
dor y el cliente. 

2. Use formateadores (explicados más adelante en este capítulo) para especi¬ 
ficar el formato en el que los datos son serializados y deserializados entre 
el servidor y el cliente. 

3 Determine cómo se activan los objetos del servidor \ cuanto dura la actu a¬ 
ción. 


Dominio de aplicación de cliente 




Dominio de aplicación de cliente 


Objeto 


Canal 


( Formateadcn^) 

Figura 36.1. Vista del entorno remoto NET 


En las siguientes secciones, aprenderá a crear la aplicación anfitriona en un 
eontexto remoto, incluyendo los detalles específicos de los formateadores. cana¬ 
les y puertos y cómo se puede activar el servidor. Después de construir el servi¬ 
dor. aprenderá a consumir el objeto remoto de una aplicación cliente. 


Cómo crear un ensamblado de servidor 
remoto 

Para empezar con la aplicación remota, necesita crear un ensamblado que 
contenga las llamadas de método reales que usara la aplicación anfitriona. Una 
v ez creado el ensamblado, cree la aplicación anfitriona que acepte peticiones de 
los métodos del ensamblado por parte de los clientes. En los siguientes pasos, 
creará el ensamblado que implemcnta los métodos que se van a llamar: 

1 Cree una nueva aplicación C# de Biblioteca de clases y llámela 
ServidorObject . Para hacerlo más sencillo, yo creé un directorio en 
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mi unidad C llamado cSharpRemoting y le agregue tres subcarpetas 
llamadas Servidor. ServidorObject y Client. Ya se imaginará 
lo que se pretende. La aplicación de biblioteca de clases ServidorOb j ect 
debe ser creada en el directorio cSharpRemoting\ServidorOb j ect. 

Esto hace que le sea más sencillo ejecutar las aplicaciones de consola que 
creará posteriormente. 

2. Tras crear la aplicación de biblioteca de clases ServidorOb j ect. agre¬ 
gue un método publico que reciba un parámetro, llamado customerID y 
devuelva el nombre del cliente de la base de datos Northwind en el SQL 
Server basado en el customer ID que se ha pasado. La clase completa 
para la aplicación ServidorOb j ect debería tener un aspecto parecido 
al listado 36.1. 

Listado 36.1. Cómo crear la aplicación ServidorObject 

using System; 

using System.Data; 

us ing System.Data.SqlClient; 

namespace ServidorObject 

{ 

public class Classi: MarshalByRefObject 

( 

public st ring t hi s Cus t. orne r ; 

pub.L íc Ciass i ( ) 

í 

Consolé.WriteLine("ServidorObject has been activated"); 

} 

public string ReturnName(string customerID) 

( 

// Crea una conexión, envía al objeto al SQL 

string cnStr - "Initial Catalog=Northwind;Data" + 
"Source=localservidor;Integrated Security-SSPI;"; 

SqlConnection en = new SqlConnection(cnStr); 

string strSQL = 

("Select CompanyName from Custorners " + 

" where CustomerID = + customerID + 

SqlCommand cmd = en.CreateCommand(); 

cmd.CommandText - strSQL; 

en.Open ( ) ; 

SqlDataReader rdr = cmd.ExecuteReader 
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(CommandBehavior.CloseConneotion¡; 

v;h i 1 e ( reír . Reaci ( : ) 

I 

t h i s C u s t; o me r - tdr . G e t S tnn .q ■ ¡ ■ ■ ; 

1 


C o n solé . Wr iteLin e ; t h i o C lí s t orne i ♦ 
" wa s r e t o r ncd t o 1.1 1 e c 1 1 cnt " ¡ ; 

r e t u r n R i: i s C n s t orne r ; 


1 


El código anterior realiza una simple petición a SQL Ser\er para tomar el 
campo ooiopa ny N o me en la base de datos Cas: caa • r a basada en el parametro 
.:;us t;oiner L U. que se pasa al método. Como puede ver. este eodigo no es dife¬ 
rente de cualquier otra biblioteca de clases que haya creado en CU. El siguiente 
paso es crear la aplicación servidor que atiende a las peticiones de esta ciase de 
biblioteca por parte del cliente. 

Cómo crear un servidor remoto 


Para crear la aplicación que distribuirá el ensamblado SorvidorOhio :t. 
que es donde realmente empezara a usar algunas de las características remotas 
creadas en el listado 36.1. debe crear una aplicación de consola llamada Servi¬ 
dor en el directorio C:\cSharpRemoting\Servidor. Esta aplicación 
anfitriona es el autentico servidor remoto que usa las características del espacio 
de nombres System. Runtime . Remo tina. 

Antes de empezar a codificar, deben describirse varias características clave 
del entorno remoto. El espacio de nombres que contiene la funcionalidad remota 
es System. Runtime. Remoting. ciñas clases se describen el la tabla 36.1. 

Tabla 36.1. Clases de System. Runt i me . Reme t: ing 


Clase 

Descripción 

ActivatedClientTypeEntry 

Almacena valores de un tipo de objeto regis¬ 
trado en el cliente como un tipo que puede 
activarse en el servidor 

ActivatedServiceTypeEntry 

Almacena valores de un tipo de objeto regis¬ 
trado en el servicio como un tipo que puede 
activarse cuando se solicita desde un cliente 
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Clase 


Descripción 


ObjectHandle 


ObjRef 

RemotingConfiguration 

RemotingException 


RemotingServices 


Ajusta referencias de objetos calculadas por 
valor, de este modo, se pueden devolver a 
través de un direccionamiento indirecto 

Almacena toda la información relevante ne¬ 
cesaria para generar un proxy y establecer 
comunicación con un objeto remoto 

Proporciona varios métodos estáticos para 
configurar la infraestructura remota 

Excepción que se inicia cuando se produce 
algún tipo de error durante la interacción re¬ 
mota 

Proporciona varios métodos para utilizar y 
publicar servidores proxy y objetos remotos. 
No se puede heredar esta clase 


RemotingTimeoutException 


ServerException 


SoapServices 

TypeEntry 


Excepción que se inicia cuando no se puede 
obtener acceso al servidor o al cliente en el 
período de tiempo previamente especificado 

Excepción que se inicia para comunicar erro¬ 
res al cliente cuando éste se conecta a apli¬ 
caciones distintas de .NET Framework que 
no pueden iniciar excepciones 

Proporciona varios métodos para utilizar y 
publicar objetos remotos en formato SOAP 

Implementa una clase base que contiene la 
información de configuración utilizada para 
activar una instancia de un tipo remoto 


WelIKnownClientTypeEntry Contiene valores de un tipo de objeto regis¬ 
trado en el cliente como objeto de tipo cono¬ 
cido (llamada única o singleton) 

WelIKnownServiceTypeEntry Contiene valores de un tipo de objeto regis¬ 
trado en el servicio como objeto de tipo co¬ 
nocido (llamada única o singleton) 


Aunque no use todas estas clases cuando escriba aplicaciones remotas, varias 
de estas clases son extremadamente importantes para implcmentar una infraes¬ 
tructura remota; es decir, la clase Obj Ref . la clase RemotingConf igurati - 
on. la clase RemotingServices y la enumeración WellKnownObjectMode. 
Aprenderá más de cada una de ellas más tarde en esta misma sección mientras 
escribe el codigo de su aplicación anfitriona. 
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Para empezar a escribir la aplicación anfitriona. debe comprender lo que la 
infraestructura remota necesita para funcionar Para recordarle los pasos necesa¬ 
rios para crear la aplicación anfitriona. revise los siguientes pasos reseñados con 
anterioridad: 

1. Especifique los canales y puertos que recodifican los objetos entre el servi¬ 
dor y el cliente. 

2. Use formateadores para especificar el formato en el que los datos son 
señalizados y deserializados entre el servidor y el cliente. 

3. Determine cómo se activan los objetos del servidor y cuánto dura la activa¬ 
ción. 

Las siguientes secciones estudian cada uno de estos pasos. 

Cómo especificar canales y puertos 

En la infraestructura remota, los canales procesan el transporte de mensajes o 
datos entre los objetos cliente y servidor. Recuerde lo que está sucediendo real¬ 
mente cuando está usando objetos remotos: está cruzando un limite, como un 
dominio de aplicación, un proceso de servidor o un equipo físico. El canal especi¬ 
fico que proporciona controla todos los detalles subyacentes de trasladar los da¬ 
tos a y desde los objetos remotos; simplemente especifique un tipo de canal y le 
harán todo el trabajo sucio. La clase System. Runt i me . Remot ing . 
Channels proporciona las implcmcntaciones para crear los canales que serán 
usados en el servidor remoto. Cuando registra un canal en su aplicación, debe 
asegurarse de que se registra antes de intentar acceder a los objetos remotos. Si no 
registra correctamente los canales se producirá un error. Si otra aplicación esta 
escuchando en el canal al que este intentando escuchar, se produce un error y su 
aplicación anfitriona no se cargará. Debe saber qué canales se están usando y que 
canal debe usar su aplicación, basándose en las solicitudes del cliente Tras decla¬ 
rar una instancia del tipo de canal que va a usar, llame al método 
RegisterChannel { ) de la clase Channel Services» que registra el ca¬ 
nal para su uso. La tabla 36.2 describe los métodos de la clase Channel- 
Services disponibles. 

Tabla 36.2. Métodos de la clase ChannelServices 


Método 

Descripción 

AsyncDispatchMessage 

De forma asincrónica, envía el mensaje 
especificado a las cadenas del servidor, 
en función de la dirección URI incrustada 


en el mensaje 
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CreateServerChannelSinkChain 


DispatchMessage 

GetChannel 


GetChannelSinkProperties 


GetUrlsForObject 


RegisterChannel 


SyncDispatchMessage 


UnregisterChannel 


Crea una cadena de receptores de canal 
para el canal especificado 

Envía las llamadas remotas de entrada 

Devuelve un canal registrado con el nom¬ 
bre especificado 

Devuelve una iDictionary de propie¬ 
dades para un proxy determinado 

Devuelve una matriz de todas las direc¬ 
ciones URL que pueden utilizarse para 
alcanzar el objeto especificado 

Registra un canal con los servicios de 
canal 

De forma asincrónica, envía el mensaje 
de entrada a las cadenas del servidor, en 
función de la dirección URI incrustada en 
el mensaje 

Anula el registro de un canal determina¬ 
do de la lista de canales registrados 


En esta tabla no aparece una propiedad de la clase ChannelServices 
llamada RegisteredChannels. que obtiene o asigna los canales registrados 
de la actual instancia de objetos. 

El siguiente fragmento de código crea y registra un canal TCP y otro EiTTP en 
los puertos específicos usando el método RegisterChannel de la clase 

ChannelServices: 

TcpChannel chanl = new TcpChannel (8085) ; 

Channel Services . Regis te rCha*nnel (chanl) ; 

HttpChannel chafi'2 - new HttpChanne1 ( 8 08 6) ; 

ChannelServices.RegisterChannel (chan2) ; 

Cuando crea un canal, también especifica un tipo de formateador para el ca¬ 
nal Las siguientes secciones describen los tipos de formateadores disponibles 


Cómo especificar un formato de canal 


Al mismo tiempo que crea un canal, también especifica un formato para el tipo 
de canal escogido. En el espacio de nombres System. Runtime . Remoting . 
Channels hay dos formateadores predeterminados disponibles: el canal TCP y 


el canal HTTP 




Espacio de nombres System.Runtime.Remoting.Channels.Tcp 

El espacio de nombres System. Runtime . Remot ing . Channe Is . Tcp 

contiene canales que usan el protocolo TCP para transportar datos entre objetos 
remotos La codificación predeterminada para TC P es la codificación binaria, lo 
que hace que sea un modo eficaz de pasar datos entre objetos remotos. Los datos 
binarios siempre ocupan menos espacio que los datos XML equivalentes pasados 
mediante SOAP en un canal HTTP La desventaja de usar el protocolo TCP es 
que es un formato propietario, de modo que sólo funciona en sistemas que com¬ 
prenden este tipo de formato. Para que el objeto remoto sea más accesible debe 
usar el canal HTTP para codificar, ya que estará pasando datos en el protocolo 
SOAP. La tabla 36.3 resume las clases disponibles en el espacio de nombres 
System.Runtime.Remoting.Channeis.Tcp. 

Tabla 36.3. Espacio de nombres System.Runtime.Remoting.Channels.Tcp 


Clase 

Descripción 

TcpChannel 

Proporciona una implementación de un canal emi¬ 
sor-receptor que utiliza el protocolo TCP para trans¬ 
mitir mensajes. Esta clase es una combinación de 
la clase TcpCIientChannel y la clase TcpSer¬ 
verChannel, lo que permite la comunicación en 
ambos sentidos a través de TCP 

TcpCIientChannel 

Proporciona una implementación de un canal de 
cliente que utiliza el protocolo TCP para transmitir 


mensajes. 

TcpServerChannel 

Proporciona una implementación de un canal de 
servidor que utiliza el protocolo TCP para transmi¬ 
tir mensajes. 


Espacio de nombres System.Runtime.Remoting.Channels.Http 

El espacio de nombres System . Runtime . Remot i ng . Channels . Ht. tp 

contiene canales que usan el protocolo HTTP para transportar datos entre objetos 
remotos. La codificación predeterminada para el protocolo HTTP es SOAP. lo 
que le convierte en un modo versátil de pasar datos entre objetos remotos. La 
tabla 36.4 resume las clases disponibles en el espacio de nombres System. 
Runtime.Remoting.Channeis.Http. 

Hasta aquí, puede agregar los espacios de nombres correctos y crear codigo 
para registrar un canal HTTP y un canal TCT para la aplicación anfitriona. El 
listado 36.2 muestra como la aplicación anfítriona debe ocuparse de que se regis¬ 
tren los canales. 
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Tabla 36.4. Espacio de nombres System.Runtime.Remoting.Channels.Http 


Clase 

Descripción 

HttpChannel 

Proporciona una implementación de un ca¬ 
nal emisor-receptor que utiliza el protocolo 
HTTP para transmitir mensajes. Esta clase 
es una combinación de las clases Http¬ 
CIientChannel HttpServerChannel, lo 
que permite la comunicación en ambos sen¬ 
tidos a través de HTTP. 

HttpCIientChannel 

Proporciona una implementación de un ca¬ 
nal de cliente que utiliza el protocolo HTTP 
para transmitir mensajes. 

HttpRemotingHandler 

Implementa un controlador ASP.NET que 
envía solicitudes al canal HTTP remoto. 

HttpRemotingHandlerFactory 

Inicializa nuevas instancias de la clase 

HttpRemotingHandler. 

HttpServerChannel 

Proporciona una implementación de un ca¬ 
nal de servidor que utiliza el protocolo HTTP 
para transmitir mensajes. 


Listado 36.2. Cómo registrar canales 


using 
us ing 
using 
using 
us ing 


System; 

System.Runtime.Remoting; 

System.Runtíme.Remoting.Channels; 
System.Runtime.Remoting.Channels.Tcp; 
System.Runtime.Remoting.Channels.Http; 


ñamespace Client 


/// <summary> 

/// Descripción resumida de Classl. 
/// </summary> 
class RemotingC1íent 
{ 


f STAThread] 

static void Main(string[ ] args) 

{ 

TcpChanne1 chanl = new TcpChanne1(8085); 
Channelservices.RegisterChannel(chanl) ; 

HttpChannel chan2 - new HttpChanne1 ( 8086) ; 
Channelservices.RegisterChannel(chan2); 
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NOTA: No necesita usar los canales HTTP y TCP en la aplicación 
anfitriona. Si está permitiendo a los clientes que llamen en los dos tipos de 
canales, puede registrar los dos tipos de canales; sin embargo, por lo gene¬ 
ral, usará un formateador, TCP o HTTP, basado en el tipo de los clientes 
que están accediendo al objeto remoto. 


Cómo activar el objeto remoto 

Para hospedar el objeto remoto solo queda registrar el ensamblado con el 
entorno remoto. En la aplicación anfitriona. antes de poder activar el ensamblado 
que contiene los métodos, debe agregar una referencia al ensamblado. Haga clic 
con el botón derecho del ratón en el objeto Ref erences en el Explorador de 
soluciones, lo que hace que aparezca el cuadro de dialogo Agregar referencia 
En la aplicación que estamos escribiendo, deberá buscar el directorio 
C : \ cSharpRemo t ing\ServidorOb j ec t y agregar el ensamblado 
ServidorOb ject. dll a la aplicación. Tras hacerlo, puede agregar el espa¬ 
cio de nombres ServidorOb ject a su archivo de clase usando la instrucción 
using. como muestra el siguiente fragmento: 

using System; 

using System.Runtime.Remoting; 

using System.Runtime.Remoting.Channels; 

using System.Runtime.Remoting.Channels.Http; 

using System.Runtime.Remoting.Channels.Tcp; 

using ServidorObject; 

Tras agregar una referencia al ensamblado remoto creado anteriormente, pue¬ 
de agregar el código que registra el objeto mediante el entorno remoto. Hay dos 
maneras de hacerlo: 

• Use el método RegisterWellKnownServiceType ( ) de la clase 
RemotingConf igurat ion para pasar el tipo de objeto que está creando, 
el UR1 del objeto y el modo de activ ación del objeto. 

• Use el método Configure () de la clase Remot ingConf igurat ion 

para pasar un archiv o de configuración con los detalles de activación del 
objeto. 

Cada método de activación funciona igual, pero almacenar los detalles de 
activ ación en un archivo de configuración le otorgan más flexibilidad si cualquie¬ 
ra de los detalles de activación cambia, como el numero de puerto del canal que 
está usando. Ya sopesaremos las v entajas y desventajas de ambos tipos de activ a- 
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ción. pero antes examine los métodos y propiedades de la clase Remoting- 
Configuration disponibles, descritos en la tabla 36.5 \ en la tabla 36.6. 
respectivamente. Además de los métodos de activación descritos anteriormente, 
puede usar muchos métodos y propiedades muy prácticos de esta clase para des¬ 
cubrir información en tiempo de ejecución sobre los objetos que está ejecutando. 

Tabla 36.5. Métodos de la clase Remot ingConf igurat ion 


Método Descripción 


Configure 

GetRegisteredActivatedClientTypes 

GetRegisteredActivatedServiceTypes 

GetRegisteredWelIKnownClientTypes 

GetRegisteredWelIKnownServiceTypes 

GetType (heredado de Object) 
IsActivationAllowed 

IsRemotelyActivatedClientType 

IsWelIKnownClientType 

RegisterActivatedClientType 


Lee el archivo de configuración y 
configura la infraestructura remo¬ 
ta. 

Recupera una matriz de tipos de ob¬ 
jetos registrados en el cliente como 
tipos que se activarán de forma re¬ 
mota. 

Recupera una matriz de tipos de ob¬ 
jetos registrados en el servicio que 
se pueden activar cuando lo solici¬ 
ta un cliente. 

Recupera una matriz de tipos de ob¬ 
jetos registrados en el cliente como 
tipos conocidos. 

Recupera una matriz de tipos de 
objetos registrados en el servicio 
como tipos conocidos. 

Obtiene el tipo de la instancia ac¬ 
tual. 

Devuelve un valor booleano que in¬ 
dica si el tipo especificado está au¬ 
torizado para ser cliente activado. 

Sobrecargado. Comprueba si el tipo 
de objeto especificado se registra 
como tipo de cliente activado de 
forma remota. 

Sobrecargado. Comprueba si el tipo 
de objeto especificado está regis¬ 
trado como tipo de cliente conoci¬ 
do. 

Sobrecargado. Registra un tipo de 
objeto en el cliente como un tipo 
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Método 


Descripción 


que se puede activar en el serví- ; 
dor. 

Sobrecargado. Registra un tipo de 
objeto en el servicio como un tipo 
que se puede activar a petición del 
cliente. 

Sobrecargado. Registra un tipo de 
objeto registrado en el cliente como 
objeto de tipo conocido (llamada 
única o singleton). 

Sobrecargado. Registra un tipo de 
objeto en el servicio como objeto 
de tipo conocido (llamada única o 
singleton). 


Tabla 36.6. 

Propiedades de la clase Remot mgCoiif igurét i 

Propiedad 

Descripción 

Applicationld 

Obtiene el ID de la aplicación que se ejecuta ac¬ 
tualmente 

ApplicationName 

Obtiene o establece el nombre de una aplicación 
remota 

Processld 

Obtiene el ID del proceso que se ejecuta actual¬ 
mente 


RegisterActivatedServiceType 


RegisterWelIKnownClientType 


RegisterWelIKnownServiceType 


Cómo registrar objetos con RegisterWelIKnownServiceType 

Para registrar un objeto con el método RegisterWel 1 Known- 
ServiceType ( ) de la clase RemotingConf i guration. sólo tiene que 
pasar el nombre de la clase, que es ServidorOb j ect. Ci ass1; el UR1 del 
objeto remoto, que es ReturnName; y el tipo de modo en el que el objeto será 
creado, que en este caso es SingleCall. Mas adelante estudiaremos la enume¬ 
ración WellKnownOb j ectMode. El listado 36.3 completa la aplicación 
anfitriona usando el método RegisterWelIKnownServiceType. 

Listado 36.3. Cómo usar RegisterWelIKnownServiceType 


usmg System; 

us ing System. Runtime . Remoting; 

usmg System. Runtime . Remoting . Channels ; 
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using System.Runtime.Remoting.Channels.Http; 
using System.Runtime.Remoting.Channels.Tcp; 
using ServidorObject; 

namespace Servidor 
{ 

/// <summary> 

/// Descripción resumida de Classl. 

/// </summary> 

class Ci ass 1 

{ 

/// < summary> 

/// El principal punto de entrada a la aplicación. 

/ / / / s umma r y > 

[STAThread] 

static void Main(string[] args) 

{ 

TcpChanne1 chanl - new TcpChannel(8085 ) ; 

ChannelSe rvices.RegisterChanne1(chanl) ; 

RemotingConfiguration.Registe rWellKnownSe rviceType ( 
t ypeof (Se rvidorObject.Cíassi), "ReturnName", 

We 11 KnownOb ] ectMode . SmgleCal 1) ; 

Consolé . Wr it eLme ( " Press any key to exit") ; 

Con solé.ReadLiue !) ; 


Como la aplicación anfitríona es una aplicación de consola, agregue la ins¬ 
trucción Consope . ReadLine al final para que la ventana de la consola per¬ 
manezca abierta mientras los objetos están usando el objeto remoto. La duración 
del canal es la cantidad de tiempo que la ventana permanece abierta. Tras cerrar 
la ventana de consola, el canal se destruye y termina la concesión de ese canal en 
particular en el entorno remoto. 

La enumeración We 11 KnownOb j ectMode contiene dos miembros que de¬ 
finen cómo se crean los objetos. Si We i 1 KnownOb j ectMode es SingleCall. 

cada petición de un cliente es atendida por una nueva instancia de objeto. Lsto 
puede representarse mediante el siguiente pseudo-código: 

Cree objeto X 

Lia me a1 metodo del objeto X 

Devuelva datos al llamador 
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D estr u y a el objeto X 

Recogida de elementos no utilizados 

Si WellKnownOb j ectMode es Sinq letón, cada petición de un cliente 
es atendida por la misma instancia de objeto. Esto puede representarse mediante 
el siguiente pseudo-eódigo: 

Cree objeto X 

Llame al método del. objeto X 

Devuelve datos al llamador 

L1ame a 1 me todo del objeto X 

Devuelva datos al llamador 

... continua hasta que el calía 1 sea destruido 

Este bucle continúa hasta que el canal con el que se registra este objeto en el 
entorno remoto es destruido. 

Dependiendo del tipo de aplicación que este escribiendo, determine el modo de 
activación que debe usar según los siguientes tactores: 

• Coste: Si crear el objeto remoto consume recursos y tiempo, usar el modo 
S íngleCül.1 puede no ser el modo mas efectivo de crear su objeto, ya 
que el objeto es destruido después de que cada cliente lo use. 

* Información de estado: Si esta almacenando información de estado, como 
propiedades, en el objeto remoto, use objetos Sinq letón, que pueden 
mantener datos de estado. 

Cómo registrar objetos con el método Configure 

Si necesita un modo más flexible de mantener los datos de configuración que 
necesita el entono remoto para registrar el objeto, puede usar el método Conf i- 
gure ( ) de la clase RemotingConf iguration. La información de configu¬ 
ración almacenada en el archivo es la misma información que puede usar en el 
método RegisterWeliKnownServieeType ( ) . Las ventajas de usar un 
archivo de configuración es que. si cualquiera de las configuraciones del objeto 
cambia, puede modificar el archivo de configuración sin cambiar el codigo. El 
esquema para realizar la configuración aparece en el listado 36.4 y la explicación 
de cada elemento en la tabla 36.7. 

Listado 36.4. Archivo de configuración remota 


< c on f i gu r a 1 1 on> 

< system. runtime.remoting> 

<a pp1ic a tio n > 

< 1 i f e t i me > 

< channels> (Instance) 

< cha nne1> (Instan c e) 

< s e rve r P r ovide r s > (Instanc e) 
<provider> (Instance) 
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' i o r. mu rter > ; I n s t a n c e i 

■ ] i enf ? y ov i 1er s > ( I n s t anoe ) 

< p r o v i d e r :> ( I n s t. anee ) 

• for rnatter > (Instance ) 


• client> 

• we11known> 
- a ■: t i vat.ed • 
''serví e e :> 

<we i 1 known '• 
a e 1 .1 va t ed > 


( C1 1 cnt Instance) 

! C 1 i e i: t I n s t. a n c e ) 

( Sor vice Instancej 
i. Ser vi ce Instance) 


<•; s oapí n t e r op> 

■' i. n t e r o p X rn 1 T y p e > 

' i nt.e r opXml El emente 
■ p r e Load> 

e h a n n e 1 s > (Te mp late) 

' •:h a n n e1> í T e mplate) 

.s e r v e r P r o v i d ers> (I n stan c e ) 
provi der > (' I n s t anee ) 

-- í o r rna tter > (Instance) 

•' e 1 1 ent Provider s > ( Ins t anee ) 

< p r o vid e r> í1ns t anee) 
f ormatter > ( Inst ance) 

• ehannelSinkProviders > 

• ■ s er ve r Previde r s > (Témplate) 
p r o v i d e r > C T e mp late) 

■■ f. o r ma 1.1. e : > (Te mp late) 

■ e 1 íentPro v i el e r s > (T e mp late) 

- pr o vidor > fT e mplate) 

• for matter > (Temp1a t e) 

- debuq 


Aunque hay muchas opciones en el archivo de configuración, sólo necesita 
usar las necesarias para su aplicación. 

Por ejemplo, el fragmento de codigo del listado 36.5 representa un archivo de 
configuración para un objeto activado con HTTP que es un objeto de modo 

Sinq1eCaJ1. 


Listado 36.5. Ejemplo de configuración de archivo 

<' configura! i. o n ' 

'■'system. runtime . r emo1 1 ng> 

< a p p1ication> 

< r: 1 íent ur 1 = "h 11p : //localservidor/ServidorObject"> 
<we11k nown t yp e = "Se r vid o r Ob je c t.C1a s s 1, 

ReturnName " 
url="http:, 

Classl.soap" /> 

</c1íent> 


<channels; 
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echarme1 ref="http" /> 

</channels > 

</application> 

</system.runtime.remoting> 

■' / configuiation> 

Tras crear el archivo de configuración, la operación de crear el objeto anfi¬ 
trión es mucho mas simple que registrar un objeto con el método Rogiske: - 
Wel iKnownServi ceType ( ) de la clase Romor i nqCon f i gurat ion. El 
codigo del listado 36.6 muestra cómo registrar el objeto mediante el método Con¬ 
figure ( ) . 

Listado 36.6. Cómo usar un archivo de configuración remota en la clase anfitriona 

n a mes p a ce Servidor 
{ 

/// <summary> 

/// Descripción resumida de Classi. 

/ / / / simún a r y > 

{ 

/// ■•summary> 

/// El principal punto de entrada a la aplicación. 

/ / / < / s umiíia r y > 

[iTAThread] 

static void Main{st ring[| axgsi 
{ 


R e mo tingConfigur ation.Configu re ("S ervidor.E xe.C on i ig") ; 

Consolé .WriteLme ("Press a n y k e y lo e i t M i ; 

Consolé . ReaclLme ( ) ; 


Como puede ver. el codigo se ha \ isto reducido de quince lineas a una 


NOTA: El nombre del archivo de configuración debe ser el nombre del 
ejecutable, incluida la extensión exe, con la extensión adicional conf ig 
añadida. En el caso de la aplicación anfítriona, el archivo de configuración 
recibirá el nombre servidor . exe . conf ig y estará en el directorio 
Bin donde está el archivo ejecutable de la aplicación anfítriona. 


La tabla 36.7 recoge todos los elementos disponibles y sus usos para el esque¬ 
ma de archiv os de configuración remota. 
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Tabla 36.7. Esquema para el archivo de configuración de valores remotos 


Elemento 


<system.runtime.remoting> 

<application> 

<lifetime> 

<channels> (Instancia) 

<channel> (Instancia) 

<serverProviders> (Instancia) 

<provider> (Instancia) 


<formatter> (Instancia) 


<clientProviders> (Instancia) 



Descripción 


Contiene información sobre objetos y 
canales remotos 

Contiene información sobre los obje¬ 
tos remotos que la aplicación consu¬ 
me y expone 

Contiene información sobre el período 
de duración de todos los objetos acti¬ 
vados en el cliente que atiende esta 
aplicación 

Contiene los canales que la aplicación 
utiliza para comunicar con objetos re¬ 
motos 

Configura el canal que la aplicación 
utiliza para comunicar con objetos re¬ 
motos 

Contiene los proveedores de recepto¬ 
res de canal que van a formar parte de 
la cadena de llamadas de receptores 
de canal predeterminada del servidor 
correspondiente a esta plantilla de ca¬ 
nal cuando se hace referencia a la plan¬ 
tilla en otro lugar del archivo de 
configuración 

Contiene el proveedor de receptores de 
canal correspondiente a un receptor de 
canal que se ha de insertar en la cade¬ 
na de receptores de canal 

Contiene el proveedor de receptores de 
canal para un receptor de formateador 
que se ha de insertar en la cadena de 
receptores de canal 

Contiene los proveedores de recepto¬ 
res de canal que van a formar parte de 
la cadena de llamadas de receptores 
de canal predeterminada del cliente 
correspondiente a esta plantilla de ca¬ 
nal cuando se hace referencia a la plan¬ 
tilla en otro lugar del archivo de 
configuración 





Elemento 


Descripción 


<client> 

<wellknown> (Instancia de cliente) 

<activated> (Instancia de cliente) 

<service> 

<wellknown> (Instancia de servicio) 

<activated> (Instancia de servicio) 

<soaplnterop> 

<interopXmlType> 

<interopXmlElement> 

<preLoad> 

<channels> (Plantilla) 

<channel> (Plantilla) 

<channelSinkProviders> 


Contiene los objetos que la aplicación 
consume 

Contiene información sobre los obje¬ 
tos (conocidos) activados en el servi¬ 
dor y que la aplicación desea consumir 

Contiene los objetos activados en el 
cliente que consume una aplicación de 
cliente 

Contiene los objetos que la aplicación 
expone a otros dominios de aplicación 
o contextos 

Contiene información sobre los obje¬ 
tos (conocidos) activados en el servi¬ 
dor y que la aplicación desea publicar 

Contiene información sobre los obje¬ 
tos activados en el cliente y que la apli¬ 
cación expone a los clientes 

Contiene las asignaciones de tipos uti¬ 
lizadas con SOAP 

Crea una asignación bidireccional en¬ 
tre un tipo de Common Language 
Runtime y un tipo XML y espacio de 
nombres XML 

Crea una asignación bidireccional en¬ 
tre un tipo de Common Language 
Runtime y un elemento XML y espacio 
de nombres XML 

Especifica el tipo para cargar las asig¬ 
naciones de las clases que extienden 

SoapAttribute 

Contiene las plantillas de canal que la 
aplicación utiliza para comunicar con 
objetos remotos 

Contiene la plantilla de canal que la 
aplicación puede especificar y configu¬ 
rar para comunicar o escuchar las soli¬ 
citudes de objetos remotos 

Contiene plantillas para proveedores de 
receptores de canal de cliente y servi- 
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Elemento 


Descripción 


<serverProviders> (Plantilla) 


<provider> (Plantilla) 


<formatter> (Plantilla) 


<clientProviders> (Plantilla) 


<debug> 


dor. Se puede hacer referencia a todos 
los proveedores de receptores de ca¬ 
nal especificados debajo de este ele¬ 
mento en cualquier lugar donde esté 
registrado un proveedor de receptores 
de canal 

Contiene plantillas de receptores de 
canal que se pueden insertar en una 
cadena de llamadas de canales de ser¬ 
vidor 

Contiene la plantilla de proveedores de 
receptores de canal correspondiente a 
un receptor de canal que se ha de in¬ 
sertar en la cadena de receptores de 
canal del servidor o cliente 

Contiene el proveedor de receptores de 
canal para un receptor de formateador 
que se ha de insertar en la cadena de j 
receptores de canal del cliente o serví- j 
dor 

Contiene plantillas de receptores de , 
canal que se pueden insertar en una 
cadena de llamadas de canales de 
cliente 

Especifica si se van a cargar tipos en 
el archivo de configuración cuando se 
inicia la aplicación 


Hasta ahora, este capítulo ha explicado los entresijos de la creación de la 
aplicación anfitriona que registra el objeto remoto con el entorno remoto. Ahora 
debe escribir la aplicación cliente que realiza las peticiones al objeto remoto, que 
es el tema de la siguiente sección 

Cómo escribir el cliente remoto 


Hasta ahora, ha creado el objeto anfitrión y la aplicación de senador anfitrión 
que gestiona las peticiones del objeto anfitrión por parte del cliente para el me¬ 
diante el entorno remoto. El ultimo paso para escribir esta aplicación remota es 
escribir la aplicación cliente que realiza las peticiones al objeto remoto. En este 
caso, el cliente llama al método ReturnName del ensamblado Servidor- 


790 





Object y pasa un parámetro customerID que usa el método P.rtur riHamo : ; 

para buscar el nombre de la compañía del cliente en la base de datos Northwind 

Para empezar, cree una nueva aplieación de consola llamada |:|icnt en el 
directorio C:\cSharpRemoting\Client. Puede llamar al objeto remoto 
con cualquier tipo de aplicación, pero para hacerlo más sencillo, crearemos una 
aplicación de consola. 

Se puede llamar al objeto remoto desde el cliente de una de estas tres formas: 

• Llamando al método GetOb j ect ( ) de la clase Act ivator. con lo que 
es activado en el servidor. 

• Llamando al método Createlnstance ( ) de la clase Act ivator. 

con lo que es activado en el cliente. 

• Usando la palabra clave new. con lo que puede ser activado en el servidor 
o en el cliente. 

La diferencia entre activ ación en el cliente y activ ación en el serv idor e s cuan¬ 
do se crea realmente el objeto. Cada tipo de activ ación puede conseguirse median¬ 
te programación o mediante un archiv o de configuración (usando el mismo formato 
descrito en la tabla 36.7). pero para la activación en cliente, se hace un viaje de 
ida y vuelta al servidor para crear el objeto cuando se invoca al método 
Createlnstance ( ) . Por el contrario, cuando un objeto es activado en el 
serv idor, el objeto servidor no se crea hasta que se hace una llamada al método 
desde el cliente. Los objetos activ ados en el servidor crean un proxy que el cliente 
puede usar para descubrir las propiedades y métodos disponibles en el objeto 
servidor. La principal desventaja de la activación en el servidor es que solo se 
permiten constructores predeterminados, de modo que si necesita pasar varios 
parámetros a un constructor de método, deberá usar una activ ación en el lado del 
cliente mediante el método Createlnstance ( ) de la elase Act ivator. 
Todos los métodos de la clase Act ivator aparecen en la tabla 36.8. 

Tabla 36.8. Métodos de la clase Activator 


Método 

Descripción 

CreateComlnstanceFrom 

Crea una instancia del objeto COM cuyo nom¬ 
bre se especifica, utilizando el archivo de en¬ 
samblado con nombre y el constructor que mejor 
coincida con los parámetros especificados 

Createlnstance 

Sobrecargado. Crea una instancia del tipo es¬ 
pecificado utilizando el constructor que mejor 
coincida con los parámetros especificados 

CreatelnstanceFrom 

Sobrecargado. Crea una instancia del tipo cuyo 
nombre se especifica, utilizando el archivo de 
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Método 


Descripción 


ensamblado con nombre y el constructor que 
mejor coincida con los parámetros especifica¬ 
dos 

GetObject Sobrecargado. Crea un proxy para un objeto re¬ 

moto en ejecución, un objeto conocido activado 
en el servidor o un servicio Web XML 


Tras decidir el tipo de aplicación necesaria para la aplicación, puede escribir 
el código cliente. El listado 36.7 muestra el código completo de la aplicación 
cliente. 

Como sucedía en el código anfitrión, debe registrar un canal en primer lugar. 
Cuando registra un canal desde el cliente, no especifica el numero de canal La 
llamada al final del URI indica al cliente la dirección en la que se encuentra el 
canal correcto, porque esta incluido en la llamada de método GetObject ( ) ; 
especifique el objeto que esta intentando crear y la localización del objeto. Tras 
crear la elase. puede llamar a métodos y establecer propiedades del mismo modo 
que en cualquier otra clase 

Listado 36.7. Aplicación de cliente remoto 


usmg System; 

us i ng Sys t. em. P.unt une . Reinot ing ; 

u.sinq S y s t. o m. P. u n t. i me . R e mo t ing . C hann els; 

us l n g S y s t. o rn. P. u n t i me . Re mo t i n g . C h a nn els .Te p ; 

u s i n g S o r v i c.1 o r Ob j e c t ; 

ñames pace C1 l ent 
! 

/// • summa r y > 

/ / / De s c: i i p.•: i on r e sumi da de C1 as s 1 . 

/ / / • / s umma z y > 

■; 1 a s .s Pemoí. i ngC1 ient 

I 

lSTAThr ead j 

s t. a t. i <: v o i d M a i n ¡ s t ring f ] a r g s | 
i 


r 1 1 a n n e 1 S e rvuo.s . Pegi s t e rChanne 1 (new T c p C h anne .1 í ) ) | 

S e r vid o z üb j e c t.C1 a s s1 >: = (Classl)Activator.GetOb je o t í 

t y p e o f ( C 1 a s si) , 

" t c p : //loc a 1 s e r v i d o r : 8 08 5/ Re t u r nName " , nu 11); 

C onsolc . VJ l 1 1 e L i n e ( % . Re t u r nName f "AL FKI " ) ) ; 

Console.ReadLine ( ) ; 
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} 


} 


Tras escribir el cliente, puede ejecutar la aplicación Ser\ idor.exe y. a conti¬ 
nuación. ejecutar la aplicación cliente: y debería obtener unos resultados simila¬ 
res a los de la figura 36.2. 

La aplicación anfitriona permanece siempre abierta, o hasta que la cierre, 
mientras cada llamada de cliente a la aplicación anfitriona devuelve el nombre de 
la compañía para ALFkl custornerID. que es la identificación de comprador 
pasada a la aplicación cliente. 



Figura 36.2. Resultados de ejecutar Servidor exe y Client exe 


Si deja el codigo de la aplicación anfitriona original en modo D i riqieCal^. 
cada vez que ejecute la aplicación cliente, el objeto serv idor se destruirá y se 
volverá a crear 

Al cambiar We 11 KnownOb j ectMode a Sinq.lcton. observara la dife¬ 
rencia entre los modos SlngleCall y Singleton. 

El siguiente fragmento de codigo muestra la aplicación anfitriona que crea el 
objeto en modo Singleton: 

Remot ingConf igurat i on . Regis t e rWel lKnown.S e r v i ceType ( 
t yp eof (Servidor Ob ject.Classl) , "ReturnName", 

Wei 1KnownObjectMode.SingleCall) ; 

La figura 36.3 muestra la diferencia entre los resultados de la aplicación 
anfitriona tras ejecutar la aplicación cliente varias veces. 

Como puede ver. el modo Singleton no destruye el objeto cuando el meto- 
do sale del contexto, mientras que el modo SingleCa i 1 necesita v olv er a crear 
el objeto cada vez que se llama al método ReturnNarne ( ) . 
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Figura 36.3. Aplicación anfitriona ejecutándose en modo SingleCall y en modo 

Singleton 


Resumen 


Este capítulo analiza detalladamente el entorno remoto de NET Al usar el 
entorno remoto, puede activar objetos a trav és de límites de proceso, dominios de 
aplicación y limites de equipo. Si va a implementar un entorno remoto, hay algu¬ 
nos temas mas avanzados en el SDK que quizás le convenga leer antes de empe¬ 
zar: 

• Crear formateadores de usuario: Puede crear formateadores de usuario si 
los formateadores TCP y HTTP no satisfacen sus necesidades de uso de 
datos. Busque Receptores y Cadenas de receptores en Framework SDK 

• Acceso remoto asincrónico: El acceso remoto es otra tecnología NET con 
capacidades asincrónicas integradas. Busque RPC asincrónico en 
Framework SDK para aprender a usar delegados y eventos con procedi¬ 
mientos remotos. 

Hay muchas buenas razones para estudiar los accesos remotos, pero antes de 
empezar, asegúrese de estudiar las capacidades de los servicios Web XML y 
ASP.NET para conseguir comunicación entre procesos. Puede ahorrarse mucho 
tiempo v esfuerzo creando las aplicaciones anfitrionas y modificando el modo en 
que sus clientes instancian objetos. 
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37 


Una de las cosas más importantes que debe recordar cuando se traslade a ( # y 
NET Framework es la seguridad. Debe asegurarse de que cuando cree aplicacio¬ 
nes con n-niveles. la seguridad sea de la máxima prioridad porque las probabili¬ 
dades de que se produzca una brecha en una aplicación distribuida son mucho 
mayores que en una aplicación independiente. Es por esto que NE I Framework 
se creo pensando en la seguridad, lo que se refleja en cada aspecto del entorno. 
NET Framework es capaz de ejecutarse de manera remota, realizar descargas 
dinámicas de nuevos componentes e incluso de ejecución dinámica Con este tipo 
de entorno, si un programador debe crear el modelo de seguridad, probablemente 
tarde mas en codificarlo que en crear el propio programa. 

Cuando cree aplicaciones, el modelo de segundad suele basarse en el nivel de 
usuario o el nivel de grupo. La aplicación realizara ciertas acciones o no. NET 
Framework proporciona a los programadores medios para segundad husada en 
funciones . que trabaja de una manera muy parecida a la seguridad de nivel de 
usuario y de nivel de grupo. La segundad basada en funciones se puede resumir 
en principios e identidades, aunque también proporciona seguridad de nivel de 
codigo. al que se hace referencia generalmente como segundad de acceso a códi¬ 
go o segundad husada en pruebas . 

Cuando un usuario inicia una aplicación que usa seguridad de acceso a codigo. 
puede tener acceso a un recurso (por ejemplo, una unidad de red), pero si el 
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codigo contenido en la aplicación no es fiable, el programa no puede acceder a la 
unidad de red. Este tipo de seguridad se basa en código móvil. Quizás no quiera 
usar una aplicación móvil y dejar a esa aplicación que acceda a todos los recursos 
a los que se ha encomendado. La seguridad basada en funciones evita que los 
programadores malintencionados escriban aplicaciones que puedan ejecutarse como 
si las estuviéramos ejecutando nosotros y realizar todo tipo de acciones en nues¬ 
tro equipo local o a través de nuestra red corporativa. 

La segundad de NET Framework se coloca sobre la seguridad ya presente en 
su sistema operativo (OS). Este segundo niv el de seguridad es mucho más exten- 
siblc que la seguridad OS. Ambos tipos de seguridad. OS y .NET Framework. 
pueden complementarse entre si. 

Este capitulo le acerca a varios temas relacionados con la seguridad, como el 
uso de funciones de Windows para determinar permisos. Aprenderá a solicitar y 
denegar permisos dentro del codigo mientras realiza operaciones de registro. Por 
ultimo, aprenderá a usar permisos basados en atributos para definir los derechos 
de su codigo en tiempo de ejecución. 

Seguridad de código 


La seguridad de acceso a código determina si se permite a un ensamblado 
ejecutarse basándose en varias unidades de prueba, como la URL de la que proce¬ 
de el ensamblado y quién autoriza el control. Al instalar NET Framework. están 
configurados los permisos predeterminados, lo que reduce enormemente las posi¬ 
bilidades de que un control que no es de confianza procedente de Internet o de una 
intranet local pueda ejecutarse en su equipo. Puede haber visto esto si ha intenta¬ 
do ejecutar algunas aplicaciones o usar algunos controles desde una unidad de red 
que exija privilegios de seguridad especiales. Estos privilegios de segundad espe¬ 
ciales incluven la escritura en un archivo de disco, leer o escribir en y desde el 
registro, además de operaciones de red. Normalmente recibirá una excepción de 
seguridad como las siguientes cuando intente hacer estas acciones si no cambia la 
directiva de segundad para que permita este tipo de comportamiento: 

Unhandled Exception: System.Security.SecurítyException: Request 

for the permis sion of type 

Syst em.Secur 1 1 y.Pe rmissions.File IOPermission 

The State of the failed permission was : 

•' I Pe r mi s s i on 

class = "System.Securit y.Permissions.FilelOPermission, ms corlib, 

V e r s 

ion-1.ú.3300.0, Culture-neutral, 

Pub1 1 cEe yToken = b77 a Seb619 3 4 e 0 8 9" 
veis ion-"1" 

Re ad = " Z : \ test.da t. " 

W r 1 1 e - - "Z: \test .d a t"/> 
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La seguridad de acceso a codigo solamente funciona en codigo \criticable. 
Durante la compilación justo a tiempo (JIT). se examina el lenguaje intermedio de 
Microsoft (MS1L) para garantizar la seguridad de tipo Ll codigo de segundad de 
tipo solo tiene acceso a las posiciones de memoria para las que tiene derechos 
Acciones como las operaciones de puntero están prohibidas, de modo que solo se 
puede entrar \ salir de las funciones desde los puntos de entrada \ salida 
predefinidos. Lsto no es un método infalible: pueden producirse errores Sin em¬ 
bargo. impide que una unidad de codigo malintencionado pueda íorzar un error en 
su aplicación y aprovechar algún error en el sistema operatixo. consiguiendo asi 
acceder a la pila. Ln estas circunstancias, cuando una unidad de codigo malicioso 
ha forzado un error, el codigo que genero el error solo puede acceder a las posi¬ 
ciones de memoria que el JIT determino que eran accesibles para el 

Directiva de seguridad de código 

La seguridad de acceso a codigo permite a una plataforma asignar un ni\ el de 
seguridad a una aplicación o ensamblado. Como esto se consigue con pruebas 
tomadas del elemento en cuestión, la seguridad de acceso a codigo también recibe 
el nombre de seguridad basada en pruebas. Las pruebas recogidas del codigo 
podrían ser la ubicación en Internet desde la que se descargo el codigo. una tirina 
digital ubicada en el código o código escrito por el propio autor 

Las directivas de seguridad de codigo definen \arios grupos de codigo. cada 
uno de los cuales tiene un conjunto de permisos C uando una aplicación se ha 
ejecutado, es analizada en busca de pruebas. Según la prueba del codigo. este se 
coloca en un grupo de código, heredando asi los permisos de ese grupo. Lstas 
directivas de seguridad pueden establecerse en el ni\el de dominio de empresa, 
equipo, usuario o aplicación, proporcionando así una alto grado de control sobre 
lo que se ejecuta y con que acceso. Puede haber permitido a su código que tenga 
derechos ilimitados, pero su administrador de red puede definir algunas directixas 
de segundad que superen a las suyas. 

Permisos de código 

Ll CLR. cuando concede permisos de seguridad, solo concede permisos al 
codigo en las operaciones que se le permite realizar. Ll C LR usa objetos llamados 
permisos para implementar este tipo de seguridad en código gestionado. Los prin¬ 
cipales usos de los permisos son los siguientes: 

• El codigo puede solicitar los permisos que pretende usar o que posiblemen¬ 
te necesite. .NET Framework tiene la tarea de determinar si estas peticio¬ 
nes son validas. Las peticiones de seguridad se conceden sólo si las pruebas 
recogidas del código lo permiten. El codigo nunca recibe mas permisos de 
los permitidos por la seguridad actual. Por otra parte, el codigo puede 
recibir menos permiso que el especificado en la petición. 
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• El CLR concede permiso al codigo basándose en varios factores: La iden¬ 
tidad del código (como la URL de la que fue obtenido, quien escribió el 
código v similares), los permisos que se solicitan y la cantidad de código 
que es de confianza, definida por las diferentes directivas de segundad. 

• F1 código puede hacer una petición para obtener un determinado permiso. 
Si se realiza una petición mediante el eodigo. todo el codigo que se ejecute 
en el contexto de la aplicación debe tener acceso al permiso para que este 
sea concedido. 

L1 codigo puede recibir tres clases de permisos, cada uno de los cuales tiene un 
proposito especifico: 

• Los permisos de codigo de acceso representan el acceso a un recurso pro¬ 
tegido o la autoridad para realizar una operación protegida. 

• Los permisos de identidad indican que el codigo tiene credenciales que 
admiten un tipo de identidad particular, como codigo que puede tener una 
identidad "Administrador" y. por tanto, ejecutarse con todos los permisos 
que pueda tener un administrador. 

• Los permisos de seguridad basada en funciones proporcionan un mecanis¬ 
mo para descubrir si un usuario (o el agente que actúa en nombre del 
usuario) tiene una identidad particular o es un miembro de un cargo espe¬ 
cífico. r r i n<:: ipa 1. ?o rmi ss i on es el único permiso de seguridad ba¬ 
sada en funciones. 

Ll tiempo de ejecución proporciona clases de permiso integradas en vanos 
nombres de espacios y proporciona compatibilidad para diseñar e implementar 
clases de permiso personalizadas. 

Seguridad de usuario 

Casi todos los sistemas de seguridad actuales implementan algo llamado segu¬ 
ridad de usuario. Estos tipos de sistemas de seguridad requieren información de 
los usuarios que solicitan acceso. Por ejemplo, deben saber quién es esa persona v 
a que elementos tiene acceso ese usuario. La seguridad de usuario desempeña un 
papel muy importante en los sistemas computerizados porque, cuando ejecuta una 
aplicación en su equipo, la aplicación suele guardar la identidad de la persona que 
la esta ejecutando. Por tanto, si ejecuta una aplicación, esa aplicación tiene todos 
los derechos y permisos en su equipo local y a través de la red que tendríamos 
nosotros. 

A diferencia de los servicios Windows, que le permiten configurar quien pare¬ 
ce estar ejecutando la aplicación, una aplicación Windows normal nunca había 
otorgado este tipo de control con anterioridad. Este hecho ha facilitado la prolife- 
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ración de muchos virus y trox anos a los que tienen que enfrentarse diariamente 
los usuarios v empresarios de ordenadores. Al permitirle determinar el tipo de 
permiso que tienen las aplicaciones en su equipo, se reduce enormemente la posi¬ 
bilidad de un ataque por parte de un codigo maligno. Operaciones, como leer el 
registro, sobrescribir archivos de sistema o recorrer su libreta de direcciones 
personal, no serán posibles. Puede probar rápidamente si sus aplicaciones se 
ejecutan según el usuario que las ejecuta probando el programa del listado 37 1 

Listado 37.1. Variables de entorno para tareas de seguridad sencillas 

usin g System; 

namespace S impleSecunty 

f 

c1 a s s Classl 

1 

[STAThread] 

s t a t i c v o i d Ma i n ( s t r i n g [,J args f 
{ 

Consolé .WnteLme ("I am currently running as:"}; 

Consolé . Wr iteLme ("User : { 0 } " , Envir onment . UserName ) ; 

Consolé .WnteLme { "Domain : 

{0}",Environment.UserDomainName); 

} 

} 

} 

Cuando ejecuta este programa, debería ver el nombre que usa para conectarse 
a Windows, además del nombre de su dominio, como muestra la figura 37 I 



Figura 37.1. La clase Environment puede ser utilizada para tareas de seguridad 

sencillas 

Si no esta conectado a un dominio de red. simplemente verá el nombre de su 
sistema como el nombre de dominio. El tipo de seguridad mas sencillo que proba- 





blcmente pueda implementar en este momento sería hacer que se compare el nom¬ 
bre de usuario y el nombre de dominio para validar una operación y. si todo es 
correcto, continuar con el programa. Esto es válido hasta que lleva su aplicación 
a otro equipo v deja de funcionar porque ha incluido nombres seguros en su 
código La siguiente sección revisa este tipo de seguridad junto con otros tipos 
sencillos. 

Seguridad .NET y basada en funciones 

La seguridad basada en funciones se basa en la clase Principal- 
Permission. Puede usar PrincipalPermission para determinar si el 
usuario actual tiene un nombre concreto (como John Doe) o si el usuario pertene¬ 
ce a un grupo particular. Esta clase es el único permiso de seguridad basado en 
funciones proporcionado por la biblioteca de clases NET Framework. 

Tras definir los objetos Identity y Principal, puede realizar compro¬ 
baciones de seguridad con ellas de uno de estos modos: 

• Usando comprobaciones de seguridad imperativa 

• Usando comprobaciones de seguridad declarativa 

• Accediendo directamente al objeto Principal 

Al utilizar codigo administrado, puede emplear comprobaciones de seguridad 
imperativa o declarativa para determinar si un objeto principal concreto es miem¬ 
bro de una función conocida, tiene una identidad conocida o representa una iden¬ 
tidad conocida que actúa en una función. Para realizar la comprobación de 
seguridad utilizando seguridad imperativa o declarativa, se debe efectuar una 
solicitud de seguridad para un objeto PrincipalPermission Durante la 
comprobación de seguridad, el entorno de ejecución común examina el objeto 
principal de quien efectúa la llamada para determinar si su identidad y su función 
coinciden con las representadas por el objeto PrincipalPermission que se 
demanda. Si el objeto principal no coincide, se inicia una excepción 
Secur ityExcept ion. Cuando esto sucede, sólo se comprueba el objeto prin¬ 
cipal del subproceso actual. La clase PrincipalPermission no produce un 
recorrido de pila con permiso de acceso a código, ya que podria causar graves 
problemas de seguridad. Además, se puede acceder directamente a los valores del 
objeto principal y realizar comprobaciones sin un objeto Principal¬ 
Permission. En este caso, basta con leer los valores del subproceso Prin¬ 
cipal actual o utilizar la autorización de ejecución del método IsInRole 

Cómo asignar las funciones Windows 

Por regla general, cuando se necesita asignar varios usuarios a funciones espe¬ 
cíficas. es mejor usar la funcionalidad de grupo integrada en Windows NT 4.0. 
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Windows 2000 y Windows XP. En lugar de añadir privilegios para cada usuario, 
puede crear un nuevo grupo con ciertos derechos de acceso \ luego agregar los 
usuarios al grupo en concreto. Estas funciones ahorran una cantidad considerable 
de tiempo y permiten a los administradores del servidor controlar una gran canti¬ 
dad de usuarios. Empecemos agregando un nuevo grupo en Windows 20001 
Windows XP 

1. Haga clic con el botón derecho del ratón en Mi PC y seleccione Adminis¬ 
trar. Cuando se abra la consola de Administración de equipos, expanda 
la vista del árbol en el cuadro izquierdo haciendo clic en Usuarios locales 
y grupos para que aparezca Grupos y haga clic en Grupos 

2 . C uando haga clic en Grupos, verá una lista de aproximadamente siete 
grupos integrados en el sistema operativo Windows, como muestra la figu¬ 
ra 37.2. 


|B Administración de equipos 


-^1, Archivo Acción Ver Ventana Ayuda 

b oh m e§ c? 


-Hlj Administración del equipo (local) 
- Herramientas del sistema 
+ Mi Visor de sucesos 




r a r p e t a s c o m p a r ti da s 
Usuarios locales y grupos 
_| Usuarios 


+ ¡££j Registros y alertas de rendirr 
JáA Administrador de dispositivos 
Almacenamiento 

+ Medios de almacenarniento e 
& Destragmentador de disco 
^j¡ Administr ación de discos 
'Servicios y Aplicaciones 


Nombre _j 

£1 Administradores 
^Duplicadores 
4% Invitados 

^ Operadores de configur,,. 
^Operadores de copia 
4R Usuar ios 
fg Lis i j a r 10 s a v a n z a d o s 
4J¡ Usuarios de escritorio te... 
4% Developers 

H e lp S e r v ices G r o u p 
4H Usuar ios del depurador 
fivS Developers 


D escripción _ 

Los administradores tienen acceso c... 
Pueden dupliL-ar archivos en un dominio 
Los Invitados tienen predeterminada... 
Los miembros en este equipo puede... 
Los operadores de copia pueden sob... 
Los usuarios no pueden hacer camtn... 
Los usuarios avanzados tienen mas ... 

A los miembros de este grupo se les ... 
.Net Developer Group 
Grupo para el Centro de ayuda y so... 
Los usuarios del depurador pueden ... 
Los desarrolladores de Visual 5tudio ... 




J 2Ü 


Figura 37.2. La administración de grupos se consigue con la consola Administración 

de equipos 


3. Haga clic con el botón derecho del ratón en el cuadro a la derecha y selec¬ 
cione Grupo nuevo. Llame a este grupo Developers. como muestra la 
figura 37.3. 

4. Tras crear este grupo, haga clic en el botón Agregar y agregue su cuenta 
de usuario al grupo. Para este ejemplo, asegúrese de que no esta en el 
grupo Administradores. Si es un administrador, quizás quiera probar la 
siguiente aplicación con otra cuenta Windows. 
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Figura 37.3. Agregue un grupo Developers a Windows 


Una vez que ha colocado el nuevo grupo, vamos a estudiar las clases 
WindowsPr incipa 1 y WindowsIdentity. Cuando se usan en conjunto, 
estas dos clases pueden determinar si el usuario actual de Windows pertenece a 
algún grupo específico. Examine la aplicación de ejemplo del listado 37.2 

Listado 37.2. WindowsPrincipal le permite comprobar la pertenencia a una función 

usmg .System; 

us i ng B y s t. em. S ecu r i t y . Pr inc ipal ; 

c las s C 1 a .s s 1 

{ 

st.at íc v o i el Main ( ) 

{ 

Vi i ndowslclent. i t y wi - Wi ndows Icient íty . Get.Cu r r ent. ( ) ; 

Vi i n el ows P r i n c i p a 1. wp - n ew Win d ows P r i n c i p a 1 (w i ) ; 

// Esto comprueba los derechos del administrador local 
// si se encuentra en un dominio 

i í (wp . TsTnRole (Vi i nd ows Bu iltlnRoie. Adm imstrator) 1 
Consol e .Wr i teLme ( "Your are an Admínistrator ! ") ; 
e 1 s e 

Consol e .Wr íteLme ( "You are not an Admínistrator. " ) ; 

i f (wp.IsInRole("POWERHOUSE\\Deve1oper") ) 

Consol e .Wr íteLme { "You are in the Developer group! "i ; 
e 1 s e 

Consolé-Wri teLme ("You are not in the Developer 
group . " ) ; 

} 

} 





Este código crea un nuevo objeto Windows J dent i t y (basándose en la iden¬ 
tidad del actual usuario) con el método GetCurrent. 

El objeto WindowsPr inc i pal usa este objeto de identidad como parámetro 
en su constructor, de modo que puede recuperar cierta información sobre la per¬ 
sona u objeto. A continuación llama al método IsInRole de la clase 
Wi ndowsPrincipal para determinar si el usuario pertenece al grupo Admi¬ 
nistradores. El método IsInRole tiene tres variaciones sobrecargadas de las 
cuales puede usar dos. 

La primera recibe una enumeración Wi ndowsBuilt TnRol e. Cuando com¬ 
pruebe la pertenencia a alguno de los grupos integrados en Windows, debe usar 
esta enumeración Dependiendo de si es un administrador, v era uno de dos mensa¬ 
jes. 

A continuación, el codigo comprueba si el usuario actual pertenece al nuevo 
grupo Developer. usando la segunda versión del método IsInRoJ o. Esta ver¬ 
sión simplemente recibe un parámetro de cadena que especifica el equipo o el 
nombre de dominio seguido por el nombre de grupo. 

En el código anterior, sustituya la palabra POWERHOUSE por el nombre de 
su dominio o equipo. Si no pertenece al grupo Administrador y Developer 
puede observ ar que esta aplicación de ejemplo solo le reconoce en el grupo Admi¬ 
nistradores. como muestra la figura 37.4. 

xíl 




Figura 37.4. Pertenencia al grupo Administradores puede confundir a IsInRole 

Esta confusión se produce porque, si es un administrador, forma parte inhe¬ 
rente de todos los grupos y tiene acceso a todo. Por tanto, cuando compruebe la 
pertenencia a funciones en sus aplicaciones, es aconsejable comprobar la perte¬ 
nencia al grupo específico y a todos los otros grupos que estén por encima del 
grupo que está comprobando. (Por ejemplo. Administradores. Usuarios preferen¬ 
tes y similares). 


cÁ C:\WINDOWS\System32\cmd.exe 




C:\>IsAdnin.exe 

Your are an Adninistrator? 

You are not in the Developer group. 


HE 
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Principales 


Cada subproceso de una aplicación .NET está asociada con un principal del 
C'LR El principal contiene una identidad que representa la identidad del usuario 
que esta ejecutando ese subproceso. Si usa una propiedad estática llamada 
Thread . CurrentPr i ncipal. puede devolver el principal actual asociado 
al subproceso 

Los objetos principales implementan la interfaz IPrincipal que sólo con¬ 
tiene un método y una propiedad La propiedad Identity devuelve el objeto 
actual de identidad y el método IsTnRole se usa para determinar si un usuario 
pertenece a una función o grupo de seguridad determinado. Actualmente. NET 
Framcvvork contiene dos clases principal: WindowsPrincipal y 
Gencr i cPr incipal. La clase GenericPrinci pa 1 se emplea cuando hace 
falta implementar un principal propio La clase WindowsPrincipal repre¬ 
senta un usuario de Windows y sus funciones o grupos asociados 

Un objeto Identity implementa la interfaz TIdentity. que sólo tiene 
tres propiedades: 

• Ñame es la cadena asociada a la identidad actual. El sistema operativo del 
prov eedor de autenticación pasa la cadena al entorno de ejecución común 
Un ejemplo de proveedor de autenticación es NTLM (Windows NT 
Challenge/Response). que autentica conexiones de Windows NT 

• isAuthenticated es un valor booleano que indica si el usuario ha 
sido autenticado. 

• Authent i cat ionType es una cadena que indica qué tipo de autenti¬ 
cación se ha usado. Algunos tipos posibles de autenticación son autentica¬ 
ción básica. Forins. kerberos. NTLM y autenticación de pasaporte 

Permisos de acceso a código 

Antes de ejecutar cualquier aplicación NET. debe pasar una serie de pruebas 
de seguridad que dan a la aplicación permiso para realizar ciertas operaciones. 
Los permisos concedidos al codigo también pueden ser solicitados en el codigo o 
denegados por código. 

Todos estos permisos están determinados por una directiv a de seguridad en la 
que .NET Framework confía. Estas directivas de seguridad contienen permisos 
para acceder a recursos, como recoge la tabla 37.1. 

Cuando ejecuta una aplicación, los derechos de cualquiera de los permisos 
anteriormente mencionados se basan únicamente en si el codigo tiene derecho al 
permiso. Es independiente del usuario que está ejecutando el codigo real. Por 
tanto, estos permisos reciben el nombre de seguridad de acceso a codigo. 
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Tabla 37.1. Permisos de acceso a código más comunes 


Recurso 

Permiso 

Descripción 

DNS 

DNSPermission 

Acceso al sistema de 
nombres de dominio. 

Variables de entorno 

EnvironmentPermission 

Acceso a las variables de 
entorno del sistema. 

Registro de eventos 

EventLogPermission 

Acceso a los registros de 
eventos, incluyendo los 
registros de eventos 
existentes y la creación 
de nuevos registros de 
eventos. 

Operaciones de archivo 

FilelOPermission 

Acceso a realizar opera¬ 
ciones como leer un ar¬ 
chivo y escribir en un 
archivo. 

Registro 

RegistryPermission 

Acceso al registro de 
Windows. 

Interfaz de usuario 

UlPermission 

Acceso a la funcio¬ 
nalidad de la interfaz. 

Web 

WebPermission 

Acceso a realizar o acep¬ 
tar conexiones en una di¬ 
rección Web. 


Cómo crear una sencilla solicitud de código 
de permiso 

En esta sección comprenderá lo sencillo que es solicitar permisos mediante 
codigo para realizar una acción específica. En este ejemplo, intentaremos leer una 
clave del registro, que indica a nombre de quien esta registrado el sistema opera¬ 
tivo en uso. 

Al usar la clase RegistryPermission. debe especificar el tipo de acceso 
solicitado al registro (leer, escribir y similares) y la clave específica a la que se 
quiere acceder Por lo general, si sólo necesita un acceso de lectura a una clav e 
concreta del registro, sólo debe solicitar permiso de lectura. De este modo se 
asegura de que no v a a sobrescribir información del registro accidentalmente y de 
que códigos posteriores, posiblemente malintencionados, puedan cambiar la in¬ 
formación. Además, siempre debe env olver sus solicitudes de permiso con algún 
tipo de controlador de errores. Si el entorno de ejecución común rechaza la solici- 
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tud de permiso, se inicia una Secur i tyExcept ion. Si efectúa esta solicitud 
en un bloque try/eatch. no obtendrá ninguna advertencia porque el error es 
controlado. Aunque puede saber que posee este tipo de permiso en su equipo, no 
puede predecir las directivas de seguridad que pueden bloquear este acceso en 
otros equipos o redes. 

Tras crear una solicitud de permiso, sólo tiene que llamar al método Dernand ( ) 
de la clase ReqistryPermiss ion. Si Dernand ( ) se ejecuta sin producir nin¬ 
guna excepción, se ha aceptado su solicitud de permiso. El listado 37.3 contiene 
el ejemplo de aplicación. 

Listado 37.3. Solicitud de permiso con un controlador de errores estructurado 

usinq System; 

u sin q Microsoft.Win 3 2 ; 

usinq System.Securíty.Permissions; 

0' 1 a .s s O 1 a .s s 1 
í 

s t a t i e v o i el Mam fstnngl ] argsí 

i 

t r y 


pegistryPernussion regPerinission = ncw 
Pe a is t ry P e rmis sion(Re qist r yP ermissionAccess.AllAcccss, 

" íi K E Y LOCAL MAC H I NE \ \ S OFTWAR E\\Mi.crosof t\\Wi ndows 
I i r r \ \ Current V e r s i o n " ) ; 

r e q Pe r raí s s i on . I>emancl ( ) f 

) 

cat ch (E y.ce ption e) 

Oons o 1 e.W rit e Lin e ( e.M e s s a qe) ; 
r e t. un; ; 

} 

p r- ci i st. r y K i :• y m y R e q Key-Reqi s t ry . Lo c a 1M a c lime; 
rny P e q Fp y -my F e q K e y . Op e n S u h K e y 
i " scETWAP.F,\ \M i c i osoí t; \\Wind ows NT\ \Cunen tVe r s ion") ; 

1 r y 
í 

Oh jes't. oVu lile - myReqKey . Ge t.Va lúe ( "Req i s t e r edOwne r " ) ; 

C: o 11 .s cie.WriteLine ( " O S R e q i s t e r e d O w 11 e r : 
í U } " , o Va 1 ue . ToSt r mq < ) ’ ; 

I 

r:a t.ch (MullReí e| enceEcept ion) 

{ 

) 

} 

} 

No ohidc que aunque la directiva de seguridad NET permita a este codigo 
ejecutarse, la directiva de seguridad del sistema operativo subyacente también 
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debe concederle permiso para ejecutarse. Tras solicitar los permisos para la clave 
del registro adecuada, sólo tiene que leer la clave Rcqi st. rodOwner y mostrar 
la información en la ventana de consola. 

Denegación de permisos 

Al igual que en el método Demaná, también puede llamar al método Dcny ( ) . 
que elimina los permisos para una operación. Por lo general, es aconsejable elimi¬ 
nar antes de hacer la llamada cualquier permiso que sepa que no va a necesitar. 
Puede solicitar permisos a medida que el código los vaya necesitando. Use el 
método Den y ( ) cuando haya completado una operación y sepa que ya no van a 
ser necesarias más operaciones. 

La denegación de permisos tiene varias funciones. Por ejemplo, si esta usando 
biblioteca de terceros, querrá asegurarse de que. tras manipular el registro, nin¬ 
gún otro codigo pueda hacerlo. La denegación de permisos es un modo de conse¬ 
guirlo. 

El código del listado 37.4 usa una versión modificada del ejemplo anterior 
para denegar en primer lugar un permiso de registro. I ras negar el permiso, 
intenta leer la clave de registro, lo que da como resultado una Security- 
Exception. Si quiere deshacer una operación Deny en el codigo. solo tiene 
que usar el método RevertDeny ( ) para eliminar la denegación de permiso: y 
cualquier intento posterior de leer la clave del registro solicitada se llevara a cabo 
con éxito. 

Listado 37.4. Denegación de permisos a los que no desea que se acceda 

using System; 

usmg Microsoft .Wm32 ; 

using System.Security.Permissions; 

class C1a ss1 
{ 

st.atic voicl Main (string [] args) 

{ 

try 

{ 

RegistryPermission regPermission - new 
RegistryPermission(RegistryPermissionAccess.Al 1 Access, 
"HKEY_LOCAL_MACHINE\\SOFTWARFA\Mi crosoft: \ \Windows 
NT\\CurrentVersion"); 

r egPe rmis sion.Deny() ; 

} 

catch (Exception e) 

{ 

Consolé .WriteLme (e .Message) ; 
return; 

I 
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Regís t r yKey myRegKey = Registry.LocalMachine; 
myP.egKey = myRegKey.OpenSubKey 
( "SOFTWARE\ \Micr osoft\ \Windows NT\\CurrentVersion") ; 
t r y 
{ 

Object oValue=myRegKey.GetValue("RegísteredOwner"); 
Console.WriteLine("OS Registered Owner: 

{0}",oValue.ToStringí)); 

} 

ca t oh (Nu 1 1 Reí e r enceException) 


} 

Si está ejecutando este ejemplo en Visual Studio. la aplicación deberá detener¬ 
se en las líneas de manipulación del registro. Al ejecutar esta aplicación desde la 
consola se genera una larga lista de errores de excepción que indican cual es el 
problema. 

Cómo usar permisos basados en atributos 

Las solicitudes de permisos de atributo son un modo de asegurarse de que tiene 
suficientes permisos para varios recursos antes de ejecutar la aplicación realmen¬ 
te. JIT y CLR analizan los atributos cuando se compila la aplicación 

Ln el listado 37.5. usa Reg i s t ryPe rmi ss i onAt t r i bu te y Demanci 
en Secur i tyAct ion. Si se concede este permiso en el tiempo de compilación, 
la aplicación no se ejecuta. No se trata siempre del mejor modo de codificar una 
aplicación; por lo general tendrá modos más eficaces de controlar errores de este 
tipo. 

Por ejemplo, al crear un programa de chat en red. no es aconsejable evitar que 
el programa se ejecute cuando no tiene derechos de E/S de archivos, va que 
siempre puede solicitar al usuario los parámetros de las operaciones. No obstan¬ 
te. sería logico no permitir que la aplicación se ejecute si no tiene acceso a opera¬ 
ciones de red. Este tipo de petición de seguridad es crucial para la operación de 
dicha aplicación. 


Listado 37.5. Cómo usar permisos de atributo 


usmg System; 

us i n g Microsoft .Wm32 ; 

using System.Securíty.Permissions; 

[RegistryPe rmis sionAttribute (Securit yAc tion.Demand) ] 
class C 1 a s s 1 
{ 

static void Mainístring[] args) 

{ 
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RegistryKey myRegKey=Registry.Loea IMa chine; 
myRegKey=myRegKey.OpenSubKey 
( "S O FTWARE\\Microsoft \\Wind ows NT\\Cur rentVeision "> ; 
try 
{ 

Ob i e c t oV a 1 ue-myRegK ey.GetValue ( "Regist erecl Ovni e r 
Consoie.WnteLme ("OS Registe red Owner : 

{ 0} ", oValue.ToString() j ; 

} 

catch (NullReferenceExceptionf 
{ 

} 

} 

} 


Directiva de seguridad 


Las directivas de seguridad son el corazón de la seguridad basada en pruebas. 
Después de que se obtiene una prueba de un ensamblado, ese codigo es asignado 
a un grupo de codigo. Este grupo de codigo. a su vez. tiene un conjunto de permi¬ 
sos que definen lo que el codigo puede y no puede hacer. No solo puede modificar 
la directiva de seguridad para que se ajuste a sus necesidades, puede modificarla 
a v arios niv eles y puede crear grupos de codigo personalizados que complementen 
las directivas de seguridad que ha definido. 

Niveles de directiva de seguridad 

Hay cuatro niveles de directivas de seguridad: empresa, equipo, dominio de 
aplicación v usuario. Todos estos niveles tienen que concordar con un permiso de 
seguridad o el permiso sera denegado, como muestra la figura 37.5. 



Figura 37.5. Los niveles de se solapan para determinar un nivel de seguridad final 
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Si cambia las directivas de su equipo para permitir ciertos tipos de operacio¬ 
nes de. por ejemplo, el código descargado de Internet, su administrador de red 
puede aplicar una directiv a de seguridad de empresa para prohibir esas operaciones. 

Grupos de código 

Todos los niv eles de directivas de seguridad contienen grupos de codigo que. a 
su vez contienen zonas para cada grupo de codigo. Este resultado es un ajuste de 
configuración de seguridad muy detallado a lo largo de todos los niveles de direc¬ 
tivas v permite que haya diferentes tipos de seguridad en cada nivel de directiva, 
dependiendo de la zona del codigo en cuestión. 

Inmediatamente dentro del grupo de código se sitúa un nodo All Codc. 
Como el propio nombre indica, estos conjuntos de permisos se aplican a todo el 
codigo. Ademas de este nodo All Code. puede agregar más nodos para satisfa¬ 
cer sus necesidades Por ejemplo, puede crear nodos para el codigo que recibe de 
los consultores o de cualquier otro tipo de fuente. 

Cuando evalúe niveles de seguridad, no olv ide el modo en el que la directiva de 
código se evalúa realmente. Los permisos para un ensamblado se unen a cada 
nivel de directiva de seguridad Al unir todos estos permisos, debe trabajar con un 
enorme conjunto de permisos. Cada uno de estos conjuntos de permisos se solapan 
para que se pueda realizar una comparación y el valor mas restrictivo para cada 
permiso se usa para el conjunto de permisos final. 

Conjuntos de permisos con nombre 

Un conjunto de permisos con nombre es un conjunto de permisos al que los 
administradores o los programadores pueden asociar un grupo de codigo. Un 
conjunto de permisos con nombre consiste en. al menos, un permiso y un nombre 
v una descripción para ese conjunto de permisos en particular. Los administrado¬ 
res pueden usar conjuntos de permisos con nombre para establecer o modificar la 
directiva de seguridad para grupos de código, de forma parecida a como se usan 
los grupos de Windows NT para gestionar los grupos de usuarios. Puede asociar 
mas de un grupo con el mismo conjunto de permisos con nombre. 

La tabla 37 2 describe el conjunto de permisos con nombre integrado propor¬ 
cionado por el entorno común de ejecución. 

Tabla 37.2. Conjuntos de permisos con nombre integrados 


Conjunto de permisos Descripción 


Nothing Sin permisos (no se puede ejecutar código) 

Execute Permiso para ejecutarse, pero no para utilizar re¬ 

cursos protegidos 
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Conjunto de permisos Descripción 


Internet 

Locallntranet 

Everything 

FullTrust 


Conjunto de permisos de directiva predetermina¬ 
do, adecuado para contenido de origen descono¬ 
cido 

Conjunto de permisos de directiva predetermina¬ 
do establecido en una empresa 

Todos los permisos estándar (integrados) excep¬ 
to el permiso de omitir la comprobación 

Acceso completo a todos los recursos 


Cómo alterar directivas de seguridad 

Antes de experimentar realmente con técnicas de codificado para solicitar y 
denegar permisos, debería familiarizarse con las herramientas disponibles para 
modificar las configuraciones de seguridad. Las configuraciones de seguridad 
estudiadas hasta ahora se guardan en archivos XML. La directiva de seguridad 
del equipo se guarda en el archivo secur i t y . confia ubicado en el directorio 
\WINNT\Microsof t. NET \ Framewor k\v:-:. \CONFIG. Las con¬ 

figuraciones de seguridad del usuario se encuentran en secur ity.confiq. 
ubicado en el directorio \Documents and SettinqsV Nombre de usua¬ 
rio >\Appli catión Data\Microsof t:\CLR Secur i t y Conf i q\ 

Puede dirigirse al Panel de control, seleccionar Herramientas adminis¬ 
trativas \ a continuación, seleccionar Configuración de Microsoft NET 
Framework para modificar todas sus necesidades de configuración. Esta 
herramienta, no solo tiene varios asistentes integrados que facilitan el proceso 
de configuración, sino que resulta mucho más sencilla de usar que un editor de 
XML 

Tras abrir la herramienta de configuración, expanda el nodo Directiva de se¬ 
gundad en tiempo de ejecución, como se muestra en la figura 37.6. 

Aquí puede ver realmente los diferentes niveles de segundad, los grupos de 
codigo para cada nivel, los conjuntos de permisos y los ensamblados de directiva. 

La operación de agregar nuevos grupos de códigos es muy sencilla. Haga clic 
con el botón derecho del ratón en el cuadro izquierdo y seleccione Nubvo Se 
abrirá un asistente que solicitará el nombre de este nuevo grupo de codigo y 
preguntara si debe ser creado como un grupo ya existente o si tiene permisos 
personalizados (véase figura 37.7). 

Este asistente le guia a través de todos los permisos disponibles e incluso le 
ofrece la Opción de empaquetar la directiva de seguridad para distribuirla en su 
empresa 
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Archivo Acción Ver Ayuda 
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-o) Cache de ensamblados 
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Figura 37.6. Herramienta de configuración de Microsoft .NET Framework 
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Si se cumple la condición de pertenencia: 

¡— Este nivel de directiva solo tendrá los permisos del 
comunto de permisos asociado a este grupo de códigos 

f Los niveles de directiva por debajo de este nivel no se evaluaran 


tceptar ~| Cancelai j Aplicar j 


Figura 37.7. Un asistente le ayuda a crear directivas de seguridad personalizadas 


Resumen 


NET Framework se basa en una inmensa cantidad de código de segundad que 
vigila cada aspecto de una aplicación o usuario. Este entorno de seguridad permi- 
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te al programador y al administrador de empresa controlar lo que permite realizar 
a una aplicación. Hemos estudiado las seguridades de identidad de usuario y de 
acceso a codigo. Si se usan conjuntamente con la seguridad del sistema operativo 
subyacente, puede crear aplicaciones más seguras. 
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Parte VI 

Apéndices 






Manual 
de XML 



A menos que haya vivido en una cueva durante los últimos años, ya había oido 
hablar de XML Sin lugar a dudas. XML ha recibido mu\ buenas criticas, mas de 
las que merece Sin embargo, a pesar de lo que pueda haber oído en algún lustroso 
folleto de marketing, no es probable que XML solucione el hambre del mundo, 
traiga la paz mundial o cure todas las enfermedades. Tías leei esta sección, do 
minará las bases de XML v sus estándares asociados, como esquemas y espacios 
de nombre hn pocas palabras. XML es un dialecto SGML simplificado diseñado 
para la interoperabilidad > esta considerado el ASCII del futuro hn la ultima 
década. ASCII ha sido el estándar tradicional para el intercambio de datos de 
texto, pero esta siendo desplazado rápidamente por XML como el nuevo estándai 
A lo largo de esta sección, aprendera a apreciar la rara elegancia de XML: su 
combinación única de pura sencillez y potencia en bruto También aprendera que 
otros estándares complementan a XML. La familia XML de estándares eomple- 
mentarios ha crecido mucho en los últimos años, de modo que. para abrex lar. solo 
le mostraremos los estándares mas relevantes. 

Objetivos de diseño de XML 

XML es un lenguaje de marcado que es extensible. Por supuesto, esto no es un 
gran descubrimiento dado que sus siglas significan (Extensible Markup Language. 



lenguaje de marcado extensible). pero merece la pena señalar este hecho evidente 
porque capta la esencia de XML. Extensihle significa que puede agregar nuevas 
palabras al lenguaje para que se adecúen a sus propósitos específicos. Un lengua¬ 
je marcado incluye símbolos especiales en un documento para cumplir alguna 
función específica. 

Esta función varía de un lenguaje de marcado a otro. Uno de los puntos fuertes 
de XML es que sus funciones son muy amplias: sirve como lenguaje universal de 
texto para los datos estructurados. 

El Lenguaje de marcado de hipertexto (HTML). Lenguaje estándar universal 
de marcado (SGML) y Formato de texto enriquecido (RTF) son otros ejemplos de 
lenguajes de marcado de ios que seguramente habrá oído hablar. 


NOTA: Como XML es un lenguaje informático universal, se ha acuñado el 
término "Esperanto para ordenadores" como un modo de referirse a XML. 
Éste es un buen símil, excepto que el esperanto no suele considerarse un 
éxito. 


Antes de introducirnos en la sintaxis y la gramática de XML. merece la pena 
examinar los diez objetivos del diseño de XML como los estipularon sus creado¬ 
res. Estos objetivos se enumeran a continuación y se explican con detalle mas 
adelante. 

Algunos de estos objetivos son de naturaleza bastante técnica y se aclararan 
mas tarde en este apéndice, cuando algunos de los términos que mencionan (por 
ejemplo, definición de tipo de documento) sean explicados. Sin embargo, la ma- 
vor parte de estos objetivos proporcionan un importante entendimiento de las 
pretensiones de XML 

I XML debe ser fácilmente utilizable en Internet. 

2. XML debe admitir una amplia variedad de aplicaciones. 

3. XML debe ser compatible con SGML. 

4 Debe ser sencillo escribir programas que procesen documentos XML 

5. El numero de características opcionales en XML debe mantenerse al míni¬ 
mo. preferentemente a cero. 

6. Los documentos XML deben ser legibles para las personas y razonable¬ 
mente claros. 

7. El diseño de XML debe ser preparado rápidamente. 

X. El diseño de XML debe ser formal y conciso. 

ó. Los documentos XML deben ser fáciles de crear. 

10. La concisión del marcado XML es de mínima importancia. 
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Objetivo 1: XML debe ser fácilmente utilizable 
en Internet 


Este objetivo no quiere decir que los documentos XML deban ser legibles para 
la actual generación de navegadores. En vez de eso. este objetivo se refiere a una 
imagen más amplia: tener en cuenta las necesidades de las aplicaciones distribui¬ 
das que se ejecutan en un entorno de red a gran escala, como Internet. Los servi¬ 
cios Web cumplen este objetivo. Respecto a los navegadores que admiten XML. 
Internet Explorer 5.x y posteriores, ademas de Netscape Navigator 6.x admiten 
XML 

Objetivo 2: XML debe admitir una amplia 
variedad de aplicaciones 


Este segundo objetivo puede entenderse como una contrapartida del primero. 
XML esta diseñado para funcionar perfectamente en Internet, pero no se limita a 
Internet La prueba de que este objetivo se ha conseguido es la gran cantidad de 
dominios de aplicación existentes fuera de la red. en las que se emplea XML. 
como publicaciones, intercambio de datos y aplicaciones de base de datos. Ade¬ 
mas. la rápida aceptación de XML se ha visto facilitada por una proliferación de 
herramientas: herramientas de autor, filtros sencillos, motores de pantalla, moto¬ 
res de formateo y conversores. 

Objetivo 3: XML debe ser compatible con SGML 

Este objetivo se formuló para que las herramientas SGML pudieran procesar 
(es decir, analizar) documentos XML. Este objetivo consta de 4 objetiv os secun¬ 
darios: 


1 Las herramientas SGML serán capaces de leer y escribir datos XML 

2. Las instancias XML son documentos SGML, tal cual, sin cambios en la 
instancia. 

3. Para cualquier documento XML. se puede generar una definición de tipo 
de documento (D I D) tal que SGML pueda producir "el mismo análisis" 
que un procesador XML. 

4. XML debe tener esencialmente la misma potencia expresiva que SGML. 

Aunque este objetivo (y sus objetivos secundarios) garantizan que un docu¬ 
mento XML también sea un documento SGML, lo contrario no se produce: un 
documento SGML NO es un documento XML. Esto es debido a que XML no 
incluye muchas de las complejas características de SGML. 
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Objetivo 4: Debe ser sencillo escribir programas 
que procesen documentos XML 


Este objetivo se medía originalmente con la prueba de que un licenciado en 
informática debería ser capaz de escribir un procesador XML básico en una o dos 
semanas. A posteriori. este objetivo cuantitativo ha resultado demasiado ambicio¬ 
so. pero la gran cantidad de procesadores XML disponibles (la mayoría gratuitos) 
es un claro indicador de que se ha conseguido este objetivo cualitativamente Sin 
embargo, la reciente proliferación de estándares relacionados con XML (XML 
Schema. X-Path. X-Link. etc.) ha hecho que se comente que XML no ha logrado 
alcanzar este objetivo concreto. 

Objetivo 5: El número de características 
opcionales en XML debe mantenerse al mínimo, 
preferentemente a cero 

Este objetivo se formulo para garantizar que existe una característica coheren¬ 
te entre todos los procesadores XML porque solo habrá una característica posible 
que implementar. Por tanto, cada procesador XML existente debe ser capaz de 
leer todos los documentos XML existentes (siempre que pueda decodificar sus 
caracteres). SGML, por otra parte, tiene muchas características opcionales en su 
especificación. Ln la practica, esto significa que la posibilidad de intercambiar un 
documento SGML, creado con un procesador SGML, a otro depende de las ca¬ 
racterísticas opcionales implementadas en cada procesador. 

Objetivo 6: Los documentos XML deben 

ser legibles para las personas y razonablemente 

claros 

Este objetivo habla por si mismo y tiene la ventaja de que se puede emplear un 
editor de texto, incluso uno mu\ básico como el Bloc de notas, para crear XML 
fu ncional. 

Objetivo 7: El diseño de XML debe 
ser preparado rápidamente 

Este objetivo se formulo para ganar la carrera por publicar un estándar Los 
creadores de XML se dieron cuenta de que si esperaban demasiado, otra organi¬ 
zación podría encontrar otro estándar 
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Objetivo 8: El diseño de XML debe ser formal 
y conciso 

Este objetivo está muy relacionado con el objetivo de facilitar la programación 
(el n° 4). Un formato de datos es fácil de usar por el usuario solamente si el 
programador puede entender fácilmente la especificación. Para conseguirlo, la 
especificación XML usa una notación empleada por los científicos informáticos 
cuando describen los lenguajes informáticos: Extended Backus-Naur Form (EBNF) 

• EBNF es un conjunto de reglas, llamadas producciones 

• Cada regla describe un fragmento específico de sintaxis 

• Un documento es válido si puede ser reducido a una sola regla específica, 
sin ninguna entrada libre, mediante la repetida aplicación de las reglas 

Objetivo 9: Los documentos XML deben ser 
fáciles de crear 

Este objetivo amplía los objetivos 4 y 6. Aunque un editor de texto es perfecto 
para pequeños documentos XML. los documentos grandes se crean mas fácilmen¬ 
te usando las herramientas especificas. Este objetivo expresa la intención de dise¬ 
ñar XML para que sea sencillo programar y crear sistemas de edición XML 

Objetivo 10: La concisión del marcado XML 
es de mínima importancia 

Este objetivo indica que. cuando se deba elegir entre la claridad y la concisión, 
se prefiera la claridad. 

Breve lección de HTML 


Como HTML es muv parecido a XML. le ofrecemos una breve sinopsis de este 
lenguaje. Si ya conoce HTML, la curva de aprendizaje de XML será menos pro¬ 
nunciada. (Si no conoce HTML, no se preocupe, le explicaremos todo paso a 
paso.) Para simplificar la presentación, nuestra explicación de HTML omite al¬ 
gunos detalles (por ejemplo, puede sugerir que algo es necesario cuando en reali¬ 
dad es opcional) y se limita a lo que tiene en común con XML. Por supuesto, ya es 
consciente de la principal diferencia entre los dos lenguajes: XML es extensible 
mientras que HTML no lo es (esto se explicará posteriormente). 

HTML es el lenguaje usado para describir páginas Web. Una pagina Web es 
un documento que contiene marcadores especiales, llamados eíupie/as. que defi- 
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non cómo debe ser presentado el contenido en un navegador Web. Un marcador 
inicial y un marcador final (a partir de ahora los llamaremos etiquetas) rodean al 
contenido, por ejemplo: <etiqueta>contenido</ etiqueta >. 

La etiqueta inicial, el contenido y la etiqueta final reciben el nombre de ele¬ 
mentos. La etiqueta inicial y la etiqueta final están rodeadas por comillas angula¬ 
res ( y >). La etiqueta final usa la misma palabra contenida en la etiqueta inicial 
precedida por una barra diagonal ( / ). De modo que si la etiqueta inicial es 
<font>. la etiqueta final debe ser </font>. Fn XML. las etiquetas distinguen entre 
mayúsculas y minúsculas, de modo que las palabras usadas en las etiquetas ini¬ 
cial y final deben tener los mismos caracteres. Por tanto, en XML. no puede usar 
font > (con / minúscula) en la etiqueta inicial y </Font> (con /"'mayúscula) en la 
etiqueta final Fn HTML, las etiquetas no distinguen entre mayúsculas y minús¬ 
culas. de modo que se aceptan etiquetas con diferente uso de mayúsculas y minús¬ 
culas. 

Fn HTML. las etiquetas que se pueden usar están predefinidas. Ejemplos de 
etiquetas HTML son hl (<hl> y </hl >) para Header 1 y b (<b:> y < / b ) 
para negrita. Conocer HTML significa saber cuándo usar cada etiqueta predefinida. 
Por ejemplo, para que la palabra "Abbreviation" aparezca en negrita en el 
navegador. escribiría b. -Abbreviat ion</b>. Cuando el nav egador lee esta 
combinación de etiqueta y contenido, elimina las etiquetas y muestra el contenido 
en negrita 

Una combinación aleatoria de etiquetas HTML y contenido no suele producir 
un documento HTML valido. Una pagina HTML debe tener una cierta estructura 
El contenido del documento debe estar entre chtml > y </html> y consta de 
una cabecera y un cuerpo Cada una de estas secciones esta delimitada por etique¬ 
tas (llamadas, evidentemente, cabecera y cuerpo) y tienen contenido, que puede 
estar rodeado por etiquetas de presentación. El listado A. 1 muestra la estructura 
de un documento HTML. Casualmente, este listado también muestra como se 
incrustan comentarios en una página HTML: <! --EL COMENTARIO SE SITÚA 
AQUÍ — 


NOTA: Los comentarios se pasan por alto y no afectan a la presentación 
de la página en el navegador. Sólo se usan para mostrar información al 
lector humano del código fuente HTML. Algunos comentarios contienen 
códigos especiales que pueden comprender programas específicos (Por ejem¬ 
plo el servidor Web), pero esto queda fuera del alcance de esta breve expli¬ 
cación de HTML. 


Listado A.l. Estructura de un documento HTML 


h r m 1 


< h e a d > 
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•! --SITUE AQUI EL CONTENI DO DE LA CABE CERA 

■: / hecid> 

v b o d y > 

SITUE AQUI EL CONTENIDO DEL CUEF D' • 

• / b o d y > 

• ,/html • 

HTML también consta de un mecanismo para agregar mas información a una 
etiqueta, llamados atributos. Un atributo especifica una propiedad que pertenece 
a una etiqueta, como el tamaño de una fuente Por ejemplo para que la palabra 
"Meaning" aparezca con tamaño 4. debería escribir 

< f ont s iOe- " 4 " >Meaning< / f ont ■ 

C omo puede ver en el ejemplo anterior, los atributos se esci íbcn en la etiqueta 
inicial v hav un espacio de separación entre el nombre de la etiqueta \ el nombre 
del atributo. Estos toman la forma 

n omb r e a t r i b u t o - v a 1 o r _ c a d e i: a 

o mostrando el elemento por completo: 

‘..etiqueta nombre atributo - val o r_r:adena -ont r-n i do- A-r iqiiot.a 

En HTML, están predefinidos los atributos que puede usar con cada etiqueta, 
igual que las etiquetas. La etiqueta fuente, por ejemplo, tiene un atributo de tama¬ 
ño. Los valores de atributo deben estar entre comillas dobles o sencillas (no im¬ 
porta cual de las dos use. mientras las comillas de apertura sean del mismo tipo 
que las de cierre). Una etiqueta puede contener mas de un atributo ( ada atributo 
esta separado por un espacio. Por ejemplo, quizas quiera especificar el borde, 
altura v anchura de una tabla, por ejemplo 

■ r ri b 4 b o r de i - " i " w i dt. h = " i b B ” Le i <i h t - "• |d U " •• / * .-¡i. i - 

En realidad. HTML también acepta valores de atributo que no están entre 
comillas. XML. por el contrario, necesita las comillas Había observado una 
tendencia: XML tiene un conjunto de reglas mas estricto que H I ML 

El listado A.2 muestra un sencillo documento H4ML. mezclando etiquetas 
(alminas con uno o más atributos) con contenido. En caso de que este intentando 
descifrar las etiquetas HTML de este documento, aquí se muestra la creación de 
una tabla HTML (una tabla H I ML tiene el aspecto de una tabla en un piocesadoi 
de texto). La tabla esta encerrada en una etiqueta ■ taiuU: Cada fila esta 
encerrada en una etiqueta <tr> (fila de tabla). En cada fila se crea una celda 
usando la etiqueta <td> (divisor de tabla) El resto del documento HTML se 
explica por sí mismo. (No se preocupe si no entiende algún detalle al leer este 
documento HTML. Esta sección es sobre XML. de modo que trata HTML de un 
modo superficial.) 
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Listado A. 2 . Un sencillo documento HTML 


ht m 1 


< h e a d > 

< 1 1 11e > A Glossary in HTML</ti11e> 
• / h e a d. > 

b o d y 


< h .1 > G1 o s s a r y < / h 1 > 

' di v a 1 1 gn ■="1e i t " > 

table border-"l" width-"359" height="110"> 

• t r > 

- td width-"125" height="22 " > 

<h>< Pont size=" 4 ">Abbreviation</f ontx/b> 

*'/td> 

<td width=" 234" he i ght. = " 2 2 " > 

b >< i ont size="4" >Meamng< / f ontx /b> 

< / t d > 

< / t. r > 
t r : 

< t d wid t h-" 12 5 " height-"2 2 " > 

ADO 
• /1 d > 

- td width="234" he i ght -"22 "> 

• ■ b > A < / b > ctive < b > D < / b > ata < b>0</b>bje c t. s 
' Vtd> 

-' /1 r 
t r ■ 

t d wi d t h= ,f 12 5 " he i ght = " 2 2 " > 

SOAP 

</td> 

td width = "2 3 4 " height-" 22 " > 

■: b :■■ S/b • : mp i e < b>O<: /b>b j ect <b> A< /b >cees s < b>P< / 

b • r o t o c o L 

■- /1 d • 

■- / t r 

< t r > 

<td v;idth=" 12 5" he i ght = "2 2 " > 

UDA 
<' /1 d > 

- t d wid.th ="2 3 4 " height-"2 2 " > 

'■ b > U < / b >n i v e r s a 1 <b > D < / b > a t a < b > A< / b > c c e s s 
</td> 

</tr > 

*' t i 

td width-"125" lleight-"22 " > 

XML 
■- / td • 

•' td width= " 2 34 " he ight = ,r 2 2 " > 

eb:• X< /b>tensible < b>M< /b>ar kup <b>L</b>anguage 

- /td-- 
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< /1 r > 
< /1 a b 1 e :> 

< / d i. V > 


< / b o d y > 


*■: / h t m 1 • 

XML = HTML con etiquetas definidas 
por el usuario 

Ahora estudiaremos XML \ explicaremos los detalles que no se explicaron 
con anterioridad, de modo que pueda crear su primer documento XML Un docu¬ 
mento XML consta de tres partes: prologo, cuerpo y epílogo. Solo es necesario el 
cuerpo del documento. L1 prologo y el epilogo pueden omitirse. 

Lsta es la estructura basica de un documento XML 

Prólogo: 

De c1a r a cion XML (opcional) 

• ! - -Situé aquí los c orne n tari o s - -- > 

D o c umen t T y p e Decíar ation (op ti onal ) 

<•. ! - - Situé aquí los c orne n t a r i o s - > 

Cuerpo: 

Document Element 

• Document :> 

• !— Situé aquí el documento 

</Document> 

Epílogo: 

<•'!-- Situé aquí los comentarios- - > 

Un documento XML comienza con un prólogo. Si excluimos los comentarios 
opcionales, el prologo contiene dos elementos principales (que también son opcio¬ 
nales). La declaración XML necesita un atributo, que sirve para especificar la 
versión de la especificación XML a la que se ajusta el documento. La declaración 
XML también tiene dos atributos opcionales: uno para especificar la codificación 
de carácter usada y otro para especificar si el documento depende de una defini¬ 
ción de tipo de documento (DTD). A continuación tiene un ejemplo de una decla¬ 
ración XML completa que usa los tres atributos. 

? xml ve r s i on= J. Ü n ene odi nq-" UTF-8 " st. andalona-"yes " ? •* 

Los atributos de la declaración XML deben usarse en el orden que aparece en 
el ejemplo. Hl atributo de versión es obligatorio y debe tener el valor " 1 0" La 
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codificación de carácter de los documentos XML y las definiciones de tipo de 
documento se explican mas adelante. 

El elemento de documento debe estar entre la etiqueta de raíz. En el ejemplo 
anterior, esta etiqueta de raíz es la etiqueta <Document>. pero puede usar cual¬ 
quier etiqueta para encerrar al elemento de documento. Por ultimo, todas las 
etiquetas de un documento XML deben anidarse adecuadamente. Si un elemento 
esta contenido en otro elemento recibe el nombre de secundario y el elemento 
contenedor recibe el nombre ác primario. Aquí tiene un ejemplo: 

• ■ B o o k CMf ecjor y - : h e s s " > 

• T i t 1 e > M y b y s t e rm' / T ü t i e. > 

-■ Aut h o r - A r on 1 J i m r o vi i t s c h -■ / Au t h o r > 

• / B o o k ■ 

En el ejemplo anterior la etiqueta <Book > es primaria para dos secundarias, 
los elementos <Author > y <Title->. La anidación correcta requiere que los 
elementos secundarios estén siempre contenidos en sus elementos primarios. En 
otras palabras, la etiqueta final de un elemento secundario no puede aparecer 
después de la etiqueta final de su elemento primario, como en el siguiente ejem¬ 
plo 


• Book • 

•• T i t. 1 e - I rnp r op<_• 2 M«rs t ±::q i 2 : XML Expíamed 

• /B'r; a • 

El epilogo, que solo puede contener comentarios (además de espacios en blan¬ 
co e instrucciones de proceso), suele omitirse. Ya esta preparado para un primer 
acercamiento a un documento XML. como el mostrado en el listado A.3. Los 
números de linea no forman parte del documento \ sólo aparecen para poder hacer 
una explicación línea a linea posterior mas sencilla. 


Listado A. 3 . Sencillo documento XML 


„ : • n¡ i v < • r s i on " ! . > i " er. r; od i x cj- M UTF 8 " s t a n d a 1 on e - " y e s ” ? 
i: : ■ ! l.i.st de 1 i d: t;.s sobre XMI. re ero mondados 
: ■ ! Comp] Irni-r ei |. rl:f# Mareo del 17, 2 nn por PGB - 

4 : • XMLBook.s ■ 

b : « Boo k 1 b RX- M r 4 • 1 ñ 9 7 - d d 4 d - 9 ” ;> 

: -.Ti r. 1 e XMIj B y E x a mp 1 e /Ti 1.1 e > 

7 * • (.a t e qo r y 'Web T 1 e ve 1 opmen t< /Category> 

R : o Au t h o r . ' R e n o i t. Ma r oh a 1 < /Author > 

o: '/Book:-' 

I u : - Roo k I S BM- " i - 8 4 1. 0 0 3 - i 1-0 " > 

1 1 : ■ Tit1e ' P r o f e s sion a 1 XML </Tibie: ■ 


1 d 
1 3 
1 4 
1 0 


(d ategor y > Internet < /Category > 

C ategor y :> Internet P r o g r a nrm mgt/Categor y > 
c: ategor y > XML < / C a t e g o r y > 

Aut hor >P i r:ha rd Ande rson- /Author> 
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16 

17 

1 8 
19 
2 O 

2 J 

■? 3 

7 4 
2 5 

2 c 
o -j 

7 8 
^ 7 

3 O 


3 4 


< Au t. h o r > M a r k Buho c k < / Au t h o r > 

<Au thor>Michael K a y</Author> 
<Author>Steven Livingst one- /Aut.hor • 
<Author>Bnan Loe.sgen< /Author • 

<Author >Didier Mar tin< /Author> 

< Author >S t ephen Mohr^/Author > 

< Au t h o r > N i k o 1 a O z u< / Au thor "> 

< Au t hor > Bruce P e a t / Au thor > 

< Au t h o r > J o n a t h a n Pumo c 1: < / Ai 1 1 h o r 
<Author>Pet er Star k</Author> 

< Au thor > Ke v i n Wi 11 1 ams <' /Author :> 

< / B o o k > 

< Book IS BN=" 0-7356-0 562- 9" > 

<Title>XML in Ac tion </T11 le> 

<Category>Internet<7Category> 

■ C a t c g o r y > XML <' / Category > 
vAu t ho r >Wi 11 i am J . Pa r dy /Au th o i ■> 

/ B o o k > 

< /XMLBooks> 


La línea Idel listado A.3 contiene una declaración completa XML que incluye 
los tres atributos. Las lineas 2 y 3 son comentarios usados en este caso para 
indicar la función de este documento. A continuación esta el cuerpo del documen¬ 
to XML. empezando por la línea 4 y terminando en la línea 34 Hste documento no 
tiene epílogo, como suele ser habitual. El elemento de documento esta entre la 
etiqueta • XMLBooks > (la etiqueta de inicio esta en la linea 4. la etiqueta final en 
la linea 34). El elemento de documento tiene tres secundarios, cada uno encerrado 
entre una etiqueta <Book>. El secundario 1 empieza en la línea 5 y finaliza en la 
linea 4. El secundario 2 empieza en la línea 10 5 y finaliza en la línea 27. El 
secundario 3 empieza en la línea 28 3 y finaliza en la línea 33. Cada elemento 

■ Rool:> tiene un atributo ISBN y una cantidad de secundarios: uno T i t i e.-, 
uno o mas <Category> y uno o mas • Author . Aquí puede apreciarse una 
ventaja significativa de XML sobre los tradicionales archivos de texto: XML. esta 
bien preparado para tratar con las estructuras primario/secundario. 

C omo creador del documento, merece la pena señalar que yo invente las eti¬ 
quetas y los atributos usados en este documento (XMLBooks. Book. ISBN. I itle. 
C ategorv. Author). Por ejemplo, otro autor podra haber preterido usar 

■ .She 1 vi.nqCategor y> en lugar de Category >. I amblen puede hacerlo 
usted mismo si esta especificación XML llega a alcanzar el objetivo numero 6 
(los documentos XML deben ser legibles para las personas y razonablemente 
claros). 


Definiciones de tipo de documento 


El documento XML mostrado en el listado A.3 tiene una estructura más defi¬ 
nida que la estructura impuesta por XML. Una definición de tipo de documento 
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(DTD) proporciona un modo de especificar esta estructura, el modelo de datos 
correspondiente al modelo de datos. Se puede realizar la comparación con un 
esquema de base de datos que defina el modelo de datos de una base de datos. Esta 
comparación funciona perfectamente porque tanto una base de datos como un 
documento XML contienen datos estructurados. La DTD es el esquema corres¬ 
pondiente al documento XML El listado A.4 muestra la DTD correspondiente al 
listado A.3. 

Listado A.4. Esquema DTD correspondiente al documento XML 

■. ? x rnj; v eisi on " 1 . O " '? > 

■ ! - - El el orne n to superior, 

XMLBs¡oks , os una lista de libros - - > 

• ■ | EI * KM E N T X MI, B o o 1: s ( B o o k + ) > 

• !-- -tln elemento Book 

contiene 1 Tifie, 1 o mas Cateqory, 

y i o mas Author 

< ! EL EME NT Book f Ti t 1 e , Category 4 ' , Authort) > 

• !-- |Jn Book tiene $ atributo requerido -■-> 

¡ATTLIST Book TSBM ID #P.EQUTRED> 

■ !-- Los elementos T i 11 e, Category, y' Author 

c on tienen te x t o - - > 

• !ELEMENT Title (# PCDATA) > 

• ! E L EM E N r i C a t e g o r y ( # P C DATA) > 

• !ELEMENT Author (# PCDATA) • 

La estructura de la DTD es muy parecida a la de Extended Backus-Naur Form 
mencionada anteriormente. La DTD es un conjunto de reglas sucesivas que des¬ 
criben cómo ensamblar los datos en el modelo de documentos XML. Cada regla 
describe un elemento específico o un atributo que el modelo puede contener. Un 
documento XML es válido si puede reducirse a una sola regla específica de la 
DTD. sin ninguna entrada libre, mediante la repetida aplicación de las reglas. 

A continuación tiene una descripción de la sintaxis usada en esta DTD. Obser¬ 
ve que la DTD usa una sintaxis diferente de la de los documentos XML 

Cada elemento se describe usando una línea de descripción de elemento. 

< ! F.TiEMENT elemcnt ñame ie 1 ement_content) :> 

eloment ñame usa la etiqueta para identificar cada elemento. En 
elemcnt cent ent. debe colocar otros elementos o # PC DATA para indicar 
que el elemento contiene texto. Los elementos hoja son elementos que no tienen 
secundarios. Estos elementos suelen especificarse como contenedores de 
#PC DATA 

Los caracteres especiales tras un nombre de elemento indican la cardinalidad 
de los elementos contenidos. La cardinalidad indica cuántos de estos elementos 
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pueden existir v si el elemento es opcional o necesario Ha> cuatro modos de 
indicar cardinalidad. 

• Un elemento contenido sin ningún símbolo especial (como T 1 1 . o en el 
listado A.4) debe aparecer exactamente una vez en el elemento que se 
define (cardinalidad: 1). 

• Un elemento contenido seguido por un signo de interrogación ('.*) es opcio¬ 
nal v solo puede aparecer una vez en el elemento (cardinalidad: 0.1). 

Los siguientes dos modos definen elementos repetidos, uno para los requeiidos 
y otro para los opcionales. 

• Un elemento contenido seguido por un signo de adición (+ ) (como Book \ 
Author en el listado A.4) es necesario y puede aparecer repetido 
(cardinalidad: 1..N). 

• Un elemento contenido seguido por un asterisco (*) (como Cateqor y en 
el listado A.4) es opcional y puede aparecer repetido (cardinality: 0..N). 

< ! ATT LIS T ele me n t ñame attnbute_ n ame a 11 r i b u t e _ c o n t. e n t 

opt. ional ity> 

Las listas de atributo se definen en una línea separada, element ñame es 
de nuevo la etiqueta a la que pertenece el atributo, attr ibute name es el 
nombre del atributo (Por ejemplo. ISBN en el listado A.4). El contenido del atn- 
buto se define usando una sene de palabras clav e. La mas común es C DA TA que 
índica que el atributo recibe datos de carácter. La opcionalidad se indica mediante 
la palabra clave #REQUIRED para los atributos necesarios y #IMPL1ED paia 
los atributos opcionales. 


Esquemas XML 

El 2 de Mayo del 200 1. el consejo encargado de controlar los estándares XML 
anunció que un importante miembro de la familia XML había alcanzado el estatus 
de estándar (una recomendación propuesta, como www . w i . orq lo llama). Este 
estándar recibe el nombre de Esquemas XML y esta destinado a reemplazar a la 
DTD como el sistema preferido de validar documentos XML. 

Esquemas XML ofrece dos ventajas evidentes sobre la DTD 

* Un esquema XML es un documento XML 

• Los esquemas XML permite especificar las características de datos (como 
tipo, tamaño v precisión) de los elementos y atributos 

Un documento de esquema tiene este aspecto: 
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< ? v ni i ve r s l on - " 1 . 0 " encod i n g= " UT F- 8 ” ? > 

Vsri : s chema mins : >:sd^ " h11 p : / /www . w3 . org/2 0 0 1 /XMLSchema 

■ ! - 5; i 1i;e aqui el contenido del esquema - - > 


• ■ / s d : s chema ■ 

El atributo irnins : ::sd del elemento de esquema es una declaración de nom¬ 
bre de espacio, que estudiaremos en la siguiente sección. Observe que el valor de 
este atributo ha cambiado a lo largo del tiempo, de modo que si se encuentra con 
un esquema con un valor diferente en este atributo (por ejemplo, www .w3.org/ 

30ou/ 1 1 i/mMLSohema), ese esquema fue creado correctamente de acuerdo con 
una versión de borrador del estándar Esquema XME 

El contenido del esquema consta de definiciones para los elementos y atributos 
que el esquema puede contener. Un elemento se define como se indica a continua¬ 
ción 

■ c d : e 1 e me n t. n a me - " t h e E1 e m e. n t H a me " • 

• ! - - i t u e aqu i i o s d eta lies o a p e c i f i c os del ele me n t o 

- />:sd : el ornent • 

\ un atributo se definen como se indica a continuación 

• :-:.sd : a 1 L i ibul e namc=" t h.eAt t nbuteMame " > 

• ! - r-; l t Lie aq:a i os de 1 a 11 es esper: i f i cos del atribuí r»- 

• / s '1 : a T 1 n but. o • 

Puede agregar documentación con comentarios o insertar un elemento de ano¬ 
tación dentro del elemento o definición de atributo. El elemento de anotación 
contiene un elemento de documentación en el que puede explicar los detalles espe¬ 
cíficos del elemento o del atributo 

■ .i : ama >t a r i t ¡ • 

• v >• I : d \ ■ ' ; ; m a W a t i : ai • :■ sane ^ 1 p 1 a n a t i o > i h < :■ r e .. .• / s d : d o--ument at i c. 11 

■ / :-:sd : aun al al. : on - 

Puede agrupar los elementos y los atributos insertándolos en una etiqueta 

/orr.r, . yiw . 

- v.s 1: ■-.iiipA'XTypa 

■ /:-;sd : somp I -x'í yp- ■ 

Este tipo de agrupación es necesario cada vez que se encuentra con una defini¬ 
ción de elemento como la siguiente: 

■ ! E L EME NT B o o k ( T i He, C a t e o o r y * , Authorh) :> 

l.os elementos agrupados en una secuencia deben ser mostrados en el orden en 
el que están definidos. 
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<xsd:sequence> 

</xsd:sequence> 

Así. si define un elemento Book como se indica a continuación, el elemento 
Book debe contener los elementos Title.Categoryy Author exactamente 
en este orden (por ejemplo. Title. Author y Category no sería válido). 

<xsd:element name="Book"> 
xsd:c omp1e x T yp e > 

<xsd:sequence> 

<xsd:element name-"Title"> 

</xsd:element> 

<xsd:element name="Category”/> 

<xsd:element name ="Author"/> 

</xsd:sequence> 

</xsd:complexType> 

< / x s d:eleme n t > 

Se considera que la cardinalidad de los elementos es uno. Si quiere crear un 
elemento repetidor, puede hacerlo agregando el atributo mazOccurs = 
"unbounded " a la definición del elemento. Si quiere crear un elemento opcio¬ 
nal. puede hacerlo agregando el atributo minOccurs= "0 " a la definición del 
elemento. Por supuesto, puede combinar estos atributos para crear un elemento 
repetidor opcional. 

Finalmente, puede especificar el tipo de datos de un elemento con el atributo 
t ype= "xsd : datatype". En nuestro ejemplo, solo usamos el tipo de datos de 
cadena. El esquema XML permite una gran variedad de tipos de datos, como 
entero, largo, fecha, hora, doble, flotante, etc.El listado A.5 enumera el esquema 
XML correspondiente a la DTD mencionada anteriormente. La extensión de ar¬ 
chivo de esquemas XML es xsd y por eso a veces se les llama XSD. 

Listado A.5. Esquema XML correspondiente a DTD 

<?xml version="1.0" encoding="UTF-8"?> 

<!—Esquema W3C para una lista de libros 

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema > 

< x s d:element name="XMLBooks"> 

<xsd:annotation> 

<xsd:documentation>The top-level element, 

XMLBooks, is a list of books.</xsd:documentation> 

</xsd:annot ation> 

<xsd:complexType> 

< xsd:sequence> 

<xsd:element name="Book" maxOccurs="unbounded > 

<xsd:annotation> 

<xsd:documentation>A Book element contains 1 
Title, 1 or more Category, and 1 or more Author.</ 
xsd:documentation> 

</xsd:annotation> 

<xsd:complexType> 
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typ e="xsd:string"> 


< x s d:sequence> 

<xsd:element name="Title 
<xsd:annotation> 

<xsd:documentation>The Title, Category, 
and Author elements contain text.</xsd:documentation> 

</xsd:annotation> 

</xsd:element> 

<xsd:element name="Category" 
typ e ="xsd:string" minOccurs="0" max0ccurs^"unbounded’7> 

<xsd: element name="Author" type = "xsd : stnng" 
maxOccurs="unbounded"/> 

</x s d:seque n c e > 

< xsd:attribute name = "ISBN" type = "xsd:string" 
use-"required" id-"isbn"> 

< xsd:annot ation> 

<xsd:documentation>A Book has 1 required 
attribute * </xsd:documentation> 

</xs d:annot ation> 

</xsd:attribute> 

</x s d:c omp1e xT yp e > 

</xsd:element> 

</xsd:sequence> 

</xsd:c omp1e x T yp e > 

</xsd:element> 

</xsd:s chema> 

El listado A.6 muestra cómo un documento XML puede hacer referencia a su 
esquema XML asociado. 

Listado A.6. Documento XML que hace referencia a su esquema XML asociado 

< ?xml versión-"1.0" encoding="UTF-8"?> 

CXMLBooks xmlns:xsi="http://www.w3.org/2001/XMLSchema-instanee" 
xsi:noNamespa ceS chemaLocation="./Books.xsd"> 

CBook ISBN="0-7897-2242-9"> 

<Title>XML By Example</Title> 

< C a t e g o r y >We b Development</Category> 

<Author>Beñoit Marcha1</Author> 

< / B o o k > 

< Book X SBN="0 - 7 3 5 6-0 5 62- 9"> 

<Title >XML m Action</Title> 

<Category>Internet</Category> 

< Category>XML</Category> 

<Author>Wi11ram J. Pardy</Author> 

< / B o o k > 

</XMLBooks > 

Espacios de nombre XML 

La cxtcnsibilidad de XML es. a la vez. una bendición y una maldición. Al 
permitir a cualquier persona crear sus propias etiquetas se corre el riesgo de crear 
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una nueva torre de Babel. Afortunadamente, los programadores de los estándares 
XML percibieron el peligro c idearon una solución, llamada espacios de nombre. 
Ya conoce el concepto de los espacios de nombres gracias a su estudio de C# (el 
mismo concepto aparece en C++. Java y otros lenguajes NET) La implcmentación 
varía un poco entre un caso y otro, pero la idea es siempre la misma. 

Se asocia un nombre único a un prefijo y se usa este prefijo para calificar los 
nombres que podrían colisionar sin el prefijo. Como XML esta basado en Web. 
los diseñadores decidieron usar URL como los nombres únicos. 

El espacio de nombres usado en un esquema XML se especifica agregando el 
atributo targetNamespace= "www . myurl. com" al esquema. Este espacio 
de nombres se define agregando un atributo especial xmlns al elemento de es¬ 
quema. Puede anexar el prefijo de espacio de nombres usando dos puntos para 
separar el atributo xmlns de prefix. El diseñador del esquema debe asegurar¬ 
se de que el valor de este atributo es único Esto suele conseguirse usando la URL 
de la compañía. 

xmlns:prefix-"http://www.myu r1.com" 

Tras definir un prefijo de espacio de nombres, debe anexarlo a todos los ele¬ 
mentos contenidos en el espacio de nombres. 

<?xml version="1.0” encoding = "UTF-8"? > 

<!“- Esquema W3C para una lista de libros --> 

<xsd:schema 

t a rgetÑamespace="www.myur1 .com" 

xmlns:xsd-"http://www.w3.org/2 001/XMLSchema" 

xmlns:book="www.myurl.com"> 

<xsd:element name = "XMLBooks " > 

< xsd:annotation> 

<xsd : documental, i on>The top-level element, 

XMLBooks, ís a list of books.</xsd:documentation> 

</xsd:annotation> 

< xsd:comp1e xT yp e > 

< x s d:sequence> 

< x s d:e1eme n t ñame = "B o o k" maxOccurs = "u nbounded"> 

<xsd:annotation> 

<xsd:documentalion>A Book element contains i 
Title, 1 or more Category, and 1 or more Author.</ 
xsd:documentation> 

</xsd:annot ation> 

< x s d:c omp1e x T yp e > 

<xsd:sequence> 

<xsd:element name-"Title" type= "xsd :'#tring" > 
<xsd:annot ation> 

<xsd:documentation>The Title, Category, 
and Author elements contain text.</xsd:documentation> 

</xsd:annotation> 

</xsd:elements 

<xsd:element ñame-"Category" 
type="xsd:string" minOccurs="0" maxOccurs^"unbounded"/> 
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t yp e = "x s d:strxng 


<xsd:element name="Author 
maxOccurs = ''unbounded'' /> 

</xsd:sequence> 

<xsd:attribute name ="ISBN" type="xsd:string" 
use="required" id="isbn"> 

<xsd:annotation> 

<xsd:documentation>A Book has 1 required 
att ribute.</xsd:documentation> 

</xsd:annotation> 

</xsd:attribute> 

</xsd:complexType> 

</xsd:element> 

</xsd:sequence> 

</xsd:complexType> 

</xsd:element> 

</xsd:schema> 

El siguiente documento XML muestra cómo crear un documento XML que 
haga referencia a un esquema usando nombres de espacio. Esto se consigue agre¬ 
gando tres atributos al elemento de raíz. El primer atributo define el prefijo usado 
por el espacio de nombres y la cadena única asociada a este espacio de nombres. 
El segundo atributo especifica qué versión del esquema XML se está usando. Por 
último, el tercer atributo le indica que espacio de nombres está usando el esquema 
XML y dónde está ubicado el esquema XML. 

<?xml version="1.0" encoding="UTF-8 " ?> 

<book:XMLBooks 

xmlns:book="www.myur1.com" 

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instanee" 
xsi:schemaLocation="www.myur1.com . \Books .xsd"> 

<Book ISBN="0-7897-224 2 - 9" > 

<Title>XML By Example</Title> 

<Category>Web Deve1opment</Category> 

<Author>Benoit Marchal</Author> 

</Book> 

<Book ISBN="0-7356-0562 - 9"> 

<Tit1e>XML ín Action</Title> 

<Category>Internet</Category> 

<Category>XML</Category> 

<Author>William J. Pardy</Author> 

< / B o o k > 

</book:XMLBooks> 

Como la mayoría de los elementos de un documento XML pertenecen al mismo 
espacio de nombres, se puede crear un espacio de nombres predeterminado y 
omitir el prefijo del espacio de nombres, por ejemplo, xmlns ="www.myurl. 
com". Para terminar, se pueden incluir varias declaraciones de espacios de nom¬ 
bres en el mismo documento XML. Esto se consigue agregando todos los atribu¬ 
tos de espacio de nombres al elemento de raiz. No obstante tenga en cuenta que un 
documento sólo puede apuntar a un esquema XML. 
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